短信验证码

通用短信验证码发送，独立于认证接口，供登录、注册、换绑手机号等场景使用。

text

POST /api/sms/code

通用短信验证码接口，支持场景：1 登录、2 注册、3 换绑手机号、4 忘记密码。限流与安全策略：

同一手机号同一场景每分钟最多 2 条；
同一手机号同一场景 5 分钟内累计超过 5 条，禁止发送 30 分钟（提示用户稍后再试）；
验证码 5 分钟有效，校验错误超过 5 次立即作废，校验成功一次性消费。短信通道只使用系统短信配置（sys_sms_config）中同时满足“启用且默认”的唯一渠道，支持阿里云、腾讯云、短信宝、SMS.cn 和云片；不存在可用默认渠道时返回“短信服务未开启，请联系管理员”。所有发送行为（成功、渠道失败、被限流拦截）均写入短信发送记录，拦截请求记录具体拦截原因。

Header 参数	类型	必填	说明
`X-Platform-Source`	`integer`	是	平台来源 1微信小程序 2微信公众号 3iOS 4Android 5H5 6支付宝小程序 7百度小程序 8抖音小程序 9QQ小程序 10快手小程序
`X-App-Version`	`string`	否	客户端版本号，服务端仅透传记录

Body 参数	类型	必填	说明
`mobile`	`string`	是	手机号
`scene`	`integer`	是	验证码场景 1登录 2注册 3换绑手机号 4忘记密码

json

{
  "code": 0,
  "msg": "success",
  "data": {
    "code": 0,
    "msg": "",
    "data": null
  }
}

成功时 data 为 null。

短信验证码 ​