更新时间:2023-12-29 GMT+08:00

校验滑块验证码

描述

该接口提供校验滑块验证码的功能。服务器收到请求,返回校验结果。用户在前台界面通过滑块操作匹配图形,使得抠图和原图吻合。然后服务器进行校验滑块验证码。

调试

您可以在API Explorer中调试该接口。

接口原型

表1 接口原型

请求方法

PUT

请求地址

/v1/usg/acs/auth/slideverifycode/check

传输协议

HTTPS

请求参数

表2 参数说明

参数

是否必须

类型

位置

描述

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。

checkType

Integer

Body

校验类型。

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

默认值:0

clientType

Integer

Body

登录客户端类型。

  • 0:Web客户端类型
  • 5:PC客户端
  • 6:移动客户端

pointX

Integer

Body

抠出图形的X轴坐标。

slideTime

Integer

Body

滑动时间,单位ms。

token

String

Body

验证码Token字符串。通过发送滑块验证码接口获取。

user

String

Body

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

状态码

表3 状态码说明

HTTP状态码

描述

200

操作成功。

400

参数异常。

401

未鉴权或鉴权失败。

403

权限受限。

500

服务端异常

响应参数

表4 响应参数

参数

类型

描述

expire

Integer

过期时间,单位:秒。

token

String

访问Token字符串。

请求消息示例

PUT /v1/usg/acs/auth/slideverifycode/check
Connection: keep-alive 
Content-Type: application/json 
Host: api.meeting.huaweicloud.com 
User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191) 

{
    "checkType": 1,
    "clientType": 0,
    "pointX": 248,
    "slideTime": 4906,
    "token": "PXB2RkHvI88hHwRv9dGFVN234I7h55lEZ",
    "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 

{
    "token": "AYXn7vT60uJwRwpC1l1KRZnQuQNJRqsLM",
    "expire": 60
}

错误码

当您使用华为云会议服务端API时,如果遇到“MMC”或者“USG”开头的错误码,请参考华为云API错误中心