OuYingJun1024
3d1e8969e6
- 新增 docs/integrations/(README + jiguang/sms/meituan/pangle/wxpay 各一篇): 记录各 SDK 集成的签名/验签/加解密/协议细节与踩坑(对齐 app/integrations 分层) - docs/api 接口文档变薄: 受影响接口头部加「集成实现」链接,把验签/RSA/CPS 签名 等重逻辑描述移到集成文档;ad-pangle-callback 验签段精简为指针 - docs/api/README 补架构说明(api 薄 / 重逻辑在 integrations) - 后端技术实现.md 目录树补全(福利/钱包/签到/省钱/发奖端点 + crud/integrations 现状), pangle/wxpay 标注移入 integrations - ad_reward_golive_checklist 路径同步 core→integrations Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
27 lines
796 B
Markdown
27 lines
796 B
Markdown
# POST /api/v1/auth/sms/send — 发送短信验证码
|
||
|
||
> 所属:Auth 组（前缀 `/api/v1/auth`） | 鉴权:无 | [← 返回 API 索引](./README.md)
|
||
>
|
||
> 集成实现:见 [integrations/sms](../integrations/sms.md)（mock 模式、频控、接真供应商 TODO）。
|
||
|
||
## 入参
|
||
|
||
| 字段 | 类型 | 必填 | 说明 |
|
||
|---|---|---|---|
|
||
| `phone` | string | ✅ | 手机号,正则 `^1\d{10}$` |
|
||
|
||
## 出参
|
||
响应 `200`:
|
||
|
||
| 字段 | 类型 | 说明 |
|
||
|---|---|---|
|
||
| `sent` | bool | 是否已发送 |
|
||
| `mock` | bool | 是否 mock 模式（true 时不真发,任意 6 位通过） |
|
||
| `cooldown_sec` | int | 多少秒后才能再次发送 |
|
||
|
||
## 错误码
|
||
- `429` 发送过频（默认 60s 冷却内重复发）
|
||
|
||
## 说明
|
||
mock 模式（`SMS_MOCK=true`）下不真发短信,仅记录冷却时间。
|