短信服务

发送短信验证码

接口

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

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

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

请求参数

参数类型必填说明
phonestring发送短信验证码的手机
signature_idinteger发送短信验证码使用的签名 ID,若不指定,将选择最新的过审签名进行发送

请求示例

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

返回示例

  1. {
  2. "status": "ok"
  3. }

状态码说明

200: 成功发送

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

402: 当前应用已欠费

验证短信验证码

接口

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

请求参数

参数类型必填说明
phonestring需要验证的手机号
codestring收到的验证码

请求示例

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

返回示例

  1. {
  2. "status": "ok"
  3. }

状态码说明

200: 成功发送

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