智慧服务,成就美好体验 项目咨询

主页 > 服务与支持 > 开发平台 > 服务端API参考 > 用户密码管理 > 企业成员忘记密码 发送验证码

入门使用

发送验证码

更新时间:2019-11-20

描述

该接口提供发送验证码,服务器收到请求,发送验证码到邮箱或者短信并返回结果。用户在前台界面通过滑块验证后,再进行发送验证码操作。

接口原型

表1 接口原型

请求方法

POST

请求地址

/rest/usg/ap/v1/verifycode/send

传输协议

HTTPS

请求参数

表2 参数说明

参数

是否必须

类型

位置

描述

user

String

Body

用户身份信息(手机号码或邮箱账号或用户真实账号)。

说明:必须和发送滑块验证码时带的用户身份信息相同。

sendMethod

String

Body

验证码发送方式。

user类型是用户真实账号时,可以选择验证码发送方式;如果没有选择的话,优先短信方式。

  • sms:短信方式
  • email:邮件方式

language

string

Body

发送的验证码短信或邮件的语言。

  • zh-CN:中文
  • en-US:英文

token

string

Body

校验滑块验证码返回的token字符串。

checkType

Integer

Body

校验类型。

  • 0:登录;
  • 1:忘记密码

响应参数

表3 参数说明

参数

类型

描述

returnCode

String

业务返回码。

returnMessage

String

返回描述。

achievementTime

String

响应产生时间。

requestId

String

请求唯一标识。

data

VerifyCodeSendResultDTO

发送验证码返回的结果。

表4 VerifyCodeSendResultDTO 数据结构

参数

类型

描述

expire

String

过期时间,单位:秒。

bindPhone

String

如果通过手机发送验证码,则该字段携带该用户绑定的手机号(手机号经过处理,屏蔽中间几位,如+8618****12345)。

bindEmail

String

如果通过邮箱发送验证码,则该字段携带用户绑定的邮箱账号(邮箱账号经过处理,屏蔽中间几位,如tes****ount@huawei.com)。

请求消息示例

POST /rest/usg/ap/v1/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: Tue, 21 May 2019 07:56:32 GMT 
Content-Type: application/json;charset=UTF-8 
Connection: keep-alive 
Pragma: No-cache 
Cache-Control: no-cache 
http_proxy_id: c94f64967745b0670c299c0688479078 

{
    "returnCode": "000000000",
    "returnMessage": "Success",
    "achievementTime": "2019-05-21 07:56:32.538 UTC",
    "requestId": "86f23a4477b582f1d79360b1fc71aec6",
    "data": {
        "expire": 180,
        "bindPhone": "+86136****9209",
        "bindEmail": null
    }
}