短信服务

发送短信验证码

接口

POST /hserve/v2.2/sms-verification-code/

支持指定短信签名向指定手机号发送短信验证码。

发送短信前请先进行短信签名审核，审核通过后才能发送短信

请求参数

参数	类型	必填	说明
phone	string	是	发送短信验证码的手机
signature_id	integer	否	发送短信验证码使用的签名 ID，若不指定，将选择最新的过审签名进行发送

请求示例

curl -X POST \
  -H "X-Hydrogen-Client-ID: [[client_id]]" \
  -H "Authorization: Hydrogen-r1 {{AccessToken}}" \
  -H "Content-Type: application/json" \
  -d '{"phone": "12345678910", "signature_id": 1}' \
  https://{{服务器域名}}/hserve/v2.2/sms-verification-code/

返回示例

{
    "status": "ok"
}

状态码说明

200: 成功发送

400: 失败（rate limit 或短信签名没有通过审核）

402: 当前应用已欠费

验证短信验证码

接口

POST /hserve/v1.8/sms-verification-code/verify/

请求参数

参数	类型	必填	说明
phone	string	是	需要验证的手机号
code	string	是	收到的验证码

请求示例

curl -X POST \
  -H "X-Hydrogen-Client-ID: [[client_id]]" \
  -H "Authorization: Hydrogen-r1 {{AccessToken}}" \
  -H "Content-Type: application/json" \
  -d '{"phone": "12345678910", "code": "352353"}' \
  https://{{服务器域名}}/hserve/v1.8/sms-verification-code/verify/

返回示例

{
    "status": "ok"
}

状态码说明

200: 成功发送

400: 验证码错误 / 参数错误