短信验证码
通用短信验证码发送,独立于认证接口,供登录、注册、换绑手机号等场景使用。
发送短信验证码
接口地址
text
POST /api/sms/code接口说明
通用短信验证码接口,支持场景:1 登录、2 注册、3 换绑手机号。限流与安全策略:
- 同一手机号同一场景每分钟最多 2 条;
- 同一手机号同一场景 5 分钟内累计超过 5 条,禁止发送 30 分钟(提示用户稍后再试);
- 验证码 5 分钟有效,校验错误超过 5 次立即作废,校验成功一次性消费。 短信通道按系统短信配置(sys_sms_config)发送;所有发送行为(成功、渠道失败、被限流拦截)均写入短信发送记录,拦截请求记录具体拦截原因。
接口参数说明
| Header 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
X-Platform-Source | integer | 是 | 平台来源 1微信小程序 2微信公众号 3iOS 4Android |
X-App-Version | string | 否 | 客户端版本号,服务端仅透传记录 |
| Body 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
mobile | string | 是 | 手机号 |
scene | integer | 是 | 验证码场景 1登录 2注册 3换绑手机号 |
响应示例
json
{
"code": 0,
"msg": "success",
"data": {
"code": 0,
"msg": "",
"data": null
}
}响应参数说明
成功时 data 为 null。