marco
a2263b48a0
- 单文件 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>
680 B
680 B
POST /api/v1/auth/sms/send — 发送短信验证码
所属:Auth 组（前缀
/api/v1/auth） | 鉴权:无 | ← 返回 API 索引
入参
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
phone |
string | ✅ | 手机号,正则 ^1\d{10}$ |
出参
响应 200:
| 字段 | 类型 | 说明 |
|---|---|---|
sent |
bool | 是否已发送 |
mock |
bool | 是否 mock 模式（true 时不真发,任意 6 位通过） |
cooldown_sec |
int | 多少秒后才能再次发送 |
错误码
429发送过频（默认 60s 冷却内重复发）
说明
mock 模式（SMS_MOCK=true）下不真发短信,仅记录冷却时间。