发送短信/邮件验证码
描述
该接口提供发送验证码的功能,服务器收到请求,发送验证码到邮箱或者短信并返回结果。用户在前台界面通过滑块验证后,再进行发送验证码操作。
调试
您可以在API Explorer中调试该接口。
URI
POST /v1/usg/acs/verifycode/send
请求参数
|
参数 |
是否必须 |
类型 |
位置 |
描述 |
|---|---|---|---|---|
|
Content-Type |
是 |
String |
Header |
Body的媒体格式 样例:application/json; charset=UTF-8 |
|
X-Request-Id |
否 |
String |
Header |
请求requestId,用来标识一路请求,用于问题跟踪定位,建议使用UUID,若不携带,则后台自动生成。 |
|
Accept-Language |
否 |
String |
Header |
语言参数,默认为中文zh-CN, 英文为en-US。 |
|
sendMethod |
否 |
String |
Body |
验证码发送方式。 user类型是用户真实账号时必选;如果没有选择的话,优先短信方式。
|
|
token |
否 |
String |
Body |
访问Token字符串。通过校验滑块验证码接口获取。 |
|
user |
是 |
String |
Body |
用户身份信息(手机号码或邮箱账号或用户真实账号)。
说明:
必须和发送滑块验证码时带的用户身份信息相同。 |
状态码
|
HTTP状态码 |
描述 |
|---|---|
|
200 |
操作成功。 |
|
400 |
参数异常。 |
|
401 |
未鉴权或鉴权失败。 |
|
403 |
权限受限。 |
|
500 |
服务端异常 |
响应参数
|
参数 |
类型 |
描述 |
|---|---|---|
|
bindEmail |
String |
如果通过邮箱发送验证码,则该字段携带用户绑定的邮箱账号(邮箱账号经过处理,屏蔽中间几位,如tes****ount@huawei.com)。 |
|
bindPhone |
String |
如果通过手机发送验证码,则该字段携带该用户绑定的手机号(手机号经过处理,屏蔽中间几位,如+86181****2345)。 |
|
expire |
Integer |
过期时间,单位:秒。 |
请求消息示例
POST /v1/usg/acs/verifycode/send
Connection: keep-alive
Content-Type: application/json
Host: api.meeting.huaweicloud.com
User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191)
{
"token": "R7PE9vsaEUHjiLsraWTF3WQhmBet16SbI",
"user": "+86136********"
}
响应消息示例
HTTP/1.1 200
Date: Wed, 18 Dec 2019 06:20:40 GMT
Content-Type: application/json;charset=UTF-8
Connection: keep-alive
Pragma: No-cache
Cache-Control: no-cache
http_proxy_id: c94f64967745b0670c299c0688479078
{
"expire":180,
"bindPhone":"+8618*********",
"bindEmail":null
}
错误码
当您使用华为云会议服务端API时,如果遇到“MMC”或者“USG”开头的错误码,请参考华为云API错误中心。