WonderableAI/shaguabijia-app-server

Files

T

marco a2263b48a0 docs: API 文档拆分为 docs/api/(索引+一接口一文件), 补全遗漏的 coupon/step

- 单文件 docs/API.md 拆成 docs/api/: README.md(传送门索引: 11 接口总览表 +
  通用约定 + 复用结构) + 11 个一接口一文件, 便于接口增多后维护
- 补全此前 API.md 与技术文档均遗漏的核心接口 coupon-step.md
  (一键领券透传 pricebot-backend, 唯一需 JWT 鉴权的业务接口)
- 更新 后端技术实现.md: 业务补"领券透传"块、目录补 coupon.py、新增 coupon/step 节、
  配置补 PRICEBOT_*、接口索引改指向 docs/api/

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-05-27 12:07:54 +08:00

773 B

Raw Permalink Blame History

POST /api/v1/auth/refresh — 刷新 token

所属:Auth 组（前缀 /api/v1/auth） | 鉴权:无（凭 body 里的 refresh_token） | ← 返回 API 索引

入参

字段	类型	必填	说明
`refresh_token`	string	✅	有效的 refresh token

出参

响应 200:TokenPair（注意:不含 user 字段）。结构见 API 索引。

错误码

401 refresh token 无效/过期/类型不对,或用户不存在/被禁用

说明

服务端校验 refresh token（验签 + 验过期 + 验类型为 refresh）并查库确认用户仍 active,然后签发全新的 access+refresh 对。客户端在请求收到 401 时由 OkHttp Authenticator 自动调用。