Skip to content

短信验证码 ​

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

发送短信验证码 ​

接口地址 ​

text
POST /api/sms/code

接口说明 ​

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

  • 同一手机号同一场景每分钟最多 2 条;
  • 同一手机号同一场景 5 分钟内累计超过 5 条,禁止发送 30 分钟(提示用户稍后再试);
  • 验证码 5 分钟有效,校验错误超过 5 次立即作废,校验成功一次性消费。 短信通道按系统短信配置(sys_sms_config)发送;所有发送行为(成功、渠道失败、被限流拦截)均写入短信发送记录,拦截请求记录具体拦截原因。

接口参数说明 ​

Header 参数类型必填说明
X-Platform-Sourceinteger是平台来源 1微信小程序 2微信公众号 3iOS 4Android
X-App-Versionstring否客户端版本号,服务端仅透传记录
Body 参数类型必填说明
mobilestring是手机号
sceneinteger是验证码场景 1登录 2注册 3换绑手机号

响应示例 ​

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

响应参数说明 ​

成功时 data 为 null。