合作伙伴中心-发送验证码:请求消息

时间:2024-07-12 10:11:55

请求消息

请求参数

参数

是否必选

参数类型

取值范围

描述

receiver_type

Integer

[1]

发送验证码的类型:

1:发送短信验证码

timeout

Integer

[1-3000]

发送验证码的超时时间。

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

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

单位:分钟。

mobile_phone

String

最大长度:32

指定发送验证码的手机号。

目前系统只支持中国手机号。

示例:13XXXXXXXXX

lang

String

最大长度:16

根据该参数的取值选择发送短信验证码的语言。

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

此参数不携带或携带值为空串或携带值为null时,取默认值zh-cn。

scene

Integer

-

验证码使用的场景,目前支持如下场景:

  • 29:注册场景
  • 18:个人银行卡实名认证场景

此参数不携带或携带值为null时,默认值为“29”;不支持携带值为空串。

customer_id

String

最大长度:64

客户账号ID。您可以调用查询客户列表接口获取customer_id。

当scene=18时此参数必填;除此之外此参数非必填,不携带或携带值为空串或携带值为null时均不做处理。

请求示例

POST  https://bss.myhuaweicloud.com/v2/bases/verificationcode/send HTTP/1.1
Content-Type: application/json
X-Auth-TokenMIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

{
    "receiver_type":1,
    "timeout": 5,
    "mobile_phone":"188****8888",
    "lang":"en-us",
    "scene": 18,
    "customer_id": "a0d736359ada40aab6502d1a828c1809"
}
support.huaweicloud.com/api-bpconsole/mc_00024.html