发送登录专用短信验证码

Web 与原生客户端共用的登录专用发码接口；不是注册或找回密码通用发码。client_credentials 客户端 Bearer 必须与后续短信授权相同。省略/null/空白区号默认 86，允许其他 1–4 位拨号前缀；本地号码用字符串保留前导零。86 按国内手机号校验，其他按 1–12 位数字校验，不从 mobile 猜测或截断国家区号。

服务端先检查私有化开关、号码、Web 来源 IP（仅 browser + web）、当前手机号对应的唯一账号资格，再执行原子发送间隔保护并调用供应商。没有管理员角色不等于不具备登录资格。重复账号、无匹配账号、设备/不可用账号按对应错误拒绝，不自动注册、不授予角色。

成功 HTTP 201 只返回 seq；正常使用通过短信获取验证码。经授权的运维诊断可在供应商明确受理、Redis 发布确认成功且当前客户端已获得本次成功响应后，从专用有效码日志取得本次验证码；此方式不代表手机实际收到。日志记录可独立关闭，仍受有效期、替换、一次消费、身份及应用绑定限制；发送失败不产生可供此方式使用的有效新码。HTTP 响应不返回验证码，也不提供验证码查询接口。供应商接受与最终手机送达是不同结果。验证码六位、有效 600 秒；同一规范化号码跨客户端共用 60 秒发送间隔。新发送成功并发布后替换旧验证码；失败不延长旧验证码有效期。应仅在成功后启动前端倒计时；429 不自动重试，504 表示结果不确定，不能立即补发。

国际区号输入允许不代表供应商已支持所有号段。国际号码输出格式未配置/未确认时返回 503105211；需按交付配置确认 +区号或 00区号格式及供应商能力。本次没有新增国际号码库。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Body 参数application/json必填

示例

虚构国内号码，仅演示结构省略区号按 86四位拨号前缀与前导零

{
    "mobileAreaCode": "86",
    "mobile": "13800000000"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

请求参数

请求示例代码

返回响应