发送验证码(旧)
功能介绍
客户注册时,如果填写了手机号,可以向对应的手机发送注册验证码,校验信息的正确性。个人银行卡方式完成实名认证时,可以向指定的手机发送验证码。
注意事项:
该接口只允许使用合作伙伴AK/SK或者Token调用。
URI
POST /v1.0/{partner_id}/partner/common-mgr/verificationcode
参数说明请参见下表。
参数 |
是否必选 |
取值范围 |
描述 |
---|---|---|---|
partner_id |
是 |
最大长度:64 |
合作伙伴ID(华为分配)。 获取方法请参见如何获取合作伙伴ID(partner_id)。 |
请求消息
请求参数
参数 |
是否必选 |
参数类型 |
取值范围 |
描述 |
---|---|---|---|---|
receiverType |
是 |
Integer |
[1] |
发送类型: 1:发送短信验证码。 |
timeout |
否 |
Integer |
[0-最大整数] |
验证码超时时间。 如果不填的话,采用系统默认超时时间5分钟。 单位:分钟 |
mobilePhone |
否 |
String |
最大长度:32 |
手机号。 目前系统只支持中国手机,必须全部是数字。 示例:13XXXXXXXXX |
countryCode |
否 |
String |
[0086] |
手机国家码,目前只支持0086。 不填写系统默认是0086。 |
lang |
否 |
String |
最大长度:128 |
根据语言如果查询不到对应模板信息,就取系统默认语言对应的模板信息。
|
scene |
否 |
String |
- |
场景,目前支持如下场景: 29:注册场景; 18:个人银行卡实名认证场景。 不填写默认为29。 |
customerId |
否 |
String |
最大长度:64 |
客户ID,如果scene=18的时候必填。 |
请求示例
POST https://bss.myhuaweicloud.com/v1.0/{partner_id}/partner/common-mgr/verificationcode HTTP/1.1 Content-Type: application/json X-Auth-Token:MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ { "receiverType":1, "mobilePhone":"xxxxxxxxxxx", "countryCode":"0086", "lang":"xxx" }
响应消息
响应参数
参数 |
参数类型 |
取值范围 |
描述 |
---|---|---|---|
error_code |
String |
最大长度:16 |
状态码。具体请参考状态码。只有失败才会返回这个参数。 |
error_msg |
String |
最大长度:1024 |
错误描述信息。只有失败才会返回这个参数。 |
响应示例
HTTP/1.1 204 No Content Content-Type: application/json;charset=UTF-8 Content-Length: length Date: response time
状态码

- 状态码4xx:由于明显的客户端错误(例如,格式错误的请求语法、参数错误等),华为云会返回4xx错误码,请及时检查请求消息的正确性,重新发起请求。
- 状态码5xx:由于华为云系统原因,导致无法完成明显有效请求的处理,可及时联系华为云客服处理。
HTTP状态码 |
错误码 |
错误描述 |
---|---|---|
400 |
CBC.0100 |
参数错误。 |
401 |
CBC.0154 |
token非法/过期。 |
403 |
CBC.0151 |
访问拒绝。 |
500 |
CBC.0999 |
其他错误。 |
500 |
CBC.4001 |
模板不存在。 |
500 |
CBC.4002 |
生成验证码失败。 |
500 |
CBC.4003 |
验证码生成成功但发送失败。 |
500 |
CBC.4005 |
手机号为空/格式不合法。 |
500 |
CBC.4015 |
发送验证码次数已达到上限(15次/小时,60次/天)。 |
