短信验证码 ( SDK >= 1.8.0 )
该接口支持向特定手机号码发送验证码,并校验验证码是否正确的功能,以此来完成一些需要确认用户身份的操作,比如:
- 使用手机号码和验证码进行登录
- 通过手机号码和验证码的方式重置密码
- 进行重要操作的验证确认等
SDK 发送短信需要在知晓云控制台开通并开启发送短信权限,操作步骤请参考本页面末尾
发送短信验证码
wx.BaaS.sendSmsCode({phone})
参数说明
参数名 | 类型 | 说明 |
---|---|---|
phone | string | 手机号 |
示例代码
wx.BaaS.sendSmsCode({phone: '1328888888'}).then(res => {
// success
console.log(res.data) // { "status": "ok" }
}).catch(e => {
// err
console.log(e.code) // 错误状态码
})
错误状态码
状态码 | 说明 |
---|---|
400 | 失败(rate limit 或参数错误) |
402 | 当前应用已欠费 |
500 | 服务错误 |
校验短信验证码
BaaS.verifySmsCode({phone, code})
参数说明
参数名 | 类型 | 说明 |
---|---|---|
phone | string | 手机号 |
code | number | 验证码 |
示例代码
wx.BaaS.verifySmsCode({phone: '132888888', code: 123456}).then(res => {
// success
console.log(res.data) // { "status": "ok" }
}).catch(e => {
// err
console.log(e.code) // 错误状态码
})
错误状态码
状态码 | 说明 |
---|---|
400 | 验证码错误 / 参数错误 |
验证码发送频次
同一企业在 1 分钟内只能发送 30 条短信,如有更高频次需求,请联系客服上调
对同一手机号码在 1 分钟内只能发送 1 条短信
对同一手机号码在 1 天内不能发送超过 10 条短信