短信验证码

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

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

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

发送短信验证码

BaaS.sendSmsCode(phone, callback)

参数说明

参数名类型说明
phonestring手机号
callbackBaseCallback回调

示例代码

  1. String phone = "12345678901";
  2. BaaS.sendSmsCode(phone, new BaseCallback<StatusResp>() {
  3. @Override
  4. public void onSuccess(StatusResp resp) {
  5. if (resp.isOk()) {
  6. // 发送短信验证码成功
  7. }
  8. }
  9. @Override
  10. public void onFailure(Throwable e) {
  11. // 发送失败
  12. }
  13. });

错误状态码

状态码说明
400失败(rate limit 或参数错误)
402当前应用已欠费
500服务错误

校验短信验证码

BaaS.verifySmsCode(phone, code, callback)

参数说明

参数名类型说明
phonestring手机号
codenumber验证码
callbackBaseCallback回调

示例代码

  1. String phone = "12345678901";
  2. String code = "123456";
  3. BaaS.verifySmsCode(phone, code, new BaseCallback<StatusResp>() {
  4. @Override
  5. public void onSuccess(StatusResp resp) {
  6. if (resp.isOk()) {
  7. // 校验通过
  8. }
  9. }
  10. @Override
  11. public void onFailure(Throwable e) {
  12. // 校验不通过
  13. }
  14. });

错误状态码

状态码说明
400验证码错误 / 参数错误

验证码发送频次

同一企业在 1 分钟内只能发送 30 条短信,如有更高频次需求,请联系客服上调

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

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

配置短信签名

短信验证码 - 图1

开启 SDK 发送短信权限

短信验证码 - 图2