更新时间:2024-01-02 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

[2]

发送类型:

2:发送邮件验证码。

timeout

Integer

[0-最大整数]

验证码超时时间。

此参数不携带或携带值为空串或携带值为null时,采用系统默认超时时间10分钟。

此参数值超过60分钟时,取值固定为5分钟。

单位:分钟

email

String

最大长度:64

指定发送邮箱地址。

lang

String

最大长度:128

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

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

此参数不携带或携带值为空串或携带值为null时,取默认语言。

请求示例

POST  https://bss-intl.myhuaweicloud.com/v1.0/{partner_id}/partner/common-mgr/verificationcode HTTP/1.1
Content-Type: application/json
X-Auth-TokenMIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

{
    "receiverType":2,
    "email":"xxxxxx@xxxxxxx",
    "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.4002

生成验证码失败。

500

CBC.4003

验证码生成成功但发送失败。

500

CBC.4004

邮箱为空/格式不合法。

500

CBC.4015

发送验证码次数已达到上限(15次/小时,60次/天)。