Skip to content

发送手机短信验证码

接口地址:/v2/sms/enduserapi/v2/sendPhoneSmsCode

请求方式:POST

请求数据类型:application/json

响应数据类型:*/*

接口描述:

发送手机短信验证码,5分钟内最后一次发送的没有被使用的短信验证码有效

请求参数:

参数名称参数说明请求类型是否必须数据类型schema
codeType短信类型(1-密码重置 2-登录 3-注册 4-注销 5-添加推送人)querytrueinteger(int32)
internationalCode国际代码querytruestring
phone手机号码querytruestring
random随机数,字符串长度固定为 16querytruestring
signature签名
生成规则:SHA256(phone + codeType + random + ts + userDomainSecret)
经过SHA256编码后的数据使用HEX_ENCODE格式。
示例:
phone:13800138000
codeType:3
random:76a6L647F02CAoN9
ts:1744773894369
userDomainSecret:57Fk69oYgbs2aWWN362NtZwYB2RqKNqQ7yZESnF5VM33
签名格式:
SHA256(13800138000376a6L647F02CAoN9174477389436957Fk69oYgbs2aWWN362NtZwYB2RqKNqQ7yZESnF5VM33)
计算后得出签名:
e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
querytruestring
ts当前毫秒时间戳,与服务器时间不能超过 10 分钟querytrueinteger(int64)
userDomain用户域querytruestring

响应状态:

状态码说明schema
200发送手机短信验证码成功返回注册码响应数据
5019手机号格式不正确
5021请输入手机号码
5023请输入用户域
5058短信发送超出频率
5059短信发送异常
5116请输入国际代码
5117请输入企业短信签名ID
5118请输入企业短信模板ID
5122没有权限使用此企业短信签名ID
5123企业短信签名ID已停用
5124没有权限使用此企业短信模板ID
5125企业短信模板ID已停用
5126短信签名和短信模板不在同一短信账号下
5128企业短信账号已停用
5188企业短信账号不存在
5202企业短信签名不存在
5209企业短信模板不存在
5216签名ID和模板ID的类型请保持一致

响应参数:

参数名称参数说明类型schema
code响应状态码integer(int32)integer(int32)
data响应数据object
extMsg扩展消息string
msg响应消息string

响应示例:

javascript
{
	"code": 0,
	"data": {},
	"extMsg": "",
	"msg": ""
}