更新时间:2022-04-25 GMT+08:00
分享

发送验证码(旧)

功能介绍

客户注册时,如果填写了手机号,可以向对应的手机发送注册验证码,校验信息的正确性。个人银行卡方式完成实名认证时,可以向指定的手机发送验证码。

注意事项:

该接口只允许使用合作伙伴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

根据语言如果查询不到对应模板信息,就取系统默认语言对应的模板信息。

  • zh-cn:中文;
  • en-us:英文。

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-TokenMIIPAgYJKoZIhvcNAQcCo...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次/天)。

分享:

    相关文档

    相关产品

关闭导读