企业版本测试
接口列表
1. SMS 短信验证码
1.1 发送验证码
向指定手机号发送 6 位数字验证码,有效期 5 分钟。
POST /api/v1/auth/sms/send
无需认证
请求体:
| 字段 | 类型 | 必填 | 说明 |
|------|------|------|------|
| phone | string | ✅ | 手机号,支持以下格式:<br>① 11 位中国大陆号码(如 13800138000)<br>② 带国际区号(如 +85212345678)<br>支持区号:+86(中国大陆)、+852(香港)、+853(澳门)、+886(台湾) |
请求示例:
中国大陆号码:
{
"phone": "13800138000"
}
港澳台号码(需带区号前缀):
{
"phone": "+85212345678"
}
成功响应: 200 OK
{
"ok": true,
"message": "验证码已发送"
}
错误响应:
| HTTP 状态码 | error | 说明 |
|-------------|-------|------|
| 400 | invalid phone number | 手机号格式不正确 |
| 400 | unsupported phone region | 不支持的手机区号(仅支持 +86/+852/+853/+886) |
| 429 | 验证码发送过于频繁,请稍后再试 | 发送频率限制(60秒内不可重复发送) |
| 500 | 短信发送失败,请稍后再试 | 短信服务异常 |
Scan to contact