短信验证码

该接口支持向特定手机号码发送验证码,并校验验证码是否正确的功能,以此来完成一些需要确认用户身份的操作,比如:

  • 使用手机号码和验证码进行登录
  • 通过手机号码和验证码的方式重置密码
  • 进行重要操作的验证确认等

SDK 发送短信需要在知晓云控制台开通并开启发送短信权限,操作步骤请参考本页面末尾

发送短信验证码

BaaS.sendSmsCode({phone, userID, signatureID})

参数说明

参数名类型说明
phoneString手机号码
userIDNumber用户 ID (对应 _userprofile 表中的 id 字段)
signatureIDInteger短信签名 ID

如果短信签名 ID (signatureID) 未指定,后端默认会选用最新审核通过的签名发送短信。

示例代码

  1. BaaS.sendSmsCode({
  2. phone: '15000000000',
  3. userID: 66879698,
  4. }).then(res => {
  5. // success
  6. }).catch(e => {
  7. // err
  8. })

返回示例

成功:HTTP:1.1 Created

  1. { "status": "ok" }

验证短信验证码

BaaS.verifySmsCode({phone, code, userID})

参数说明

参数名类型说明
phoneString手机号码
codeNumber验证码
userIDNumber用户 ID (对应 _userprofile 表中的 id 字段)

示例代码

  1. BaaS.verifySmsCode({
  2. phone: '15000000000',
  3. code: 123456,
  4. userID: 66879698,
  5. }).then(res => {
  6. // success
  7. }).catch(e => {
  8. // err
  9. })

返回示例

成功:HTTP:1.1 Created

  1. { "status": "ok" }

验证码发送频次

对同一手机号码在 1 分钟内只能发送 1 条短信

对同一手机号码在 1 天内不能发送超过 10 条短信

开通短信验证码功能

配置短信签名

短信验证码 - 图1

开启 SDK 发送短信权限

短信验证码 - 图2