发送注册短信

在启用手机验证的注册流程中发送短信验证码。需要先取得 register_sms 场景的图形验证码。

POST /app/auth/sms

调用方： 随附宿主应用　·　认证： 无需登录，流程中保留 PHPSID

登录前也可调用。涉及验证码或短信时，要在整个流程中保留同一个 PHPSID 会话。

请求参数

JSON Body

参数	类型	必填	说明
mobile	string	是	中国大陆 11 位手机号，格式为 1 后接 3–9，再接 9 位数字。
captcha	string	是	同一 PHPSID 会话下 register_sms 场景的 4 位英文图形验证码。

请求示例

curl 'https://example.com/app/auth/sms' \
  -b cookies.txt -c cookies.txt \
  -H 'Content-Type: application/json' \
  --data '{"mobile":"13800138000","captcha":"aBcD"}'

使用说明

• 发送成功后保留相同 PHPSID，在注册请求中提交 mobile 和 sms_code。
• 发送过快时可能返回 HTTP 429，并通过 Retry-After 响应头给出等待秒数。不要用自动循环重发。

返回参数

成功响应的最外层字段如下。下面所有业务字段都位于 data 中。

字段	类型	说明
code	integer	0 表示成功；非 0 时查看 msg，不把 data 当成功结果使用。
msg	string	成功通常为 ok，失败时为错误说明。
data	object	本次请求的业务结果，字段见下表。

data 字段

字段	类型	说明
retry_after	integer	再次允许发送前需要等待的秒数，当前为 60。
expires_in	integer	短信验证码有效秒数，当前为 300。

返回示例

示例展示字段结构；ID、时间和资料仅作说明，请使用实际回包。

{
  "code": 0,
  "msg": "ok",
  "data": {
    "retry_after": 60,
    "expires_in": 300
  }
}

错误处理

3003 图形验证码错误、3008 发送过快、3009 短信功能不可用、3010 手机号已使用、3011 发送失败。

先检查 HTTP 状态，再检查 code。业务失败可能仍为 HTTP 200；非 0 的 code 都不能当成功。完整错误码见请求约定。

返回随附宿主账号接口列表 · HTTP 请求约定