更新时间:2024-04-29 GMT+08:00

发送滑块验证码

描述

该接口提供发送滑块验证码的功能。服务器收到请求,返回抠图以及抠图后的原图等结果。需要在前台界面显示出抠图以及抠图后的原图,用户通过滑块操作来匹配图形。

图1 发送滑块验证示例图

调试

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

接口原型

表1 接口原型

请求方法

POST

请求地址

/v1/usg/acs/auth/slideverifycode/send

传输协议

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。

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

clientType

Integer

Body

登录的客户端类型。

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

user

String

Body

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

状态码

表3 状态码说明

HTTP状态码

描述

200

操作成功。

400

参数异常。

401

未鉴权或鉴权失败。

403

权限受限。

500

服务端异常

响应参数

表4 响应参数

参数

类型

描述

cutImage

String

抠出的图形。

expire

Integer

验证码有效时间,单位:秒。

pointY

Integer

抠出图形的Y轴座标。

shadowImage

String

抠出图形后的原背景图。通过“data:url”方式来定义图片。

token

String

验证码Token字符串。

请求消息示例

POST /v1/usg/acs/auth/slideverifycode/send
Connection: keep-alive 
Host: api.meeting.huaweicloud.com
User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191) 

{
    "user": "+86136********",
    "checkType": 1,
    "clientType": 0
}

响应消息示例

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 

{
    "shadowImage": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAASwAAABuCAYAAACdmi6mAACAAElEQVR42py953cV19rtuUsi44QDNjY4YAMGSQQFJCFEkhBJoCwhlHMOKKGEUBZIIJFzxgQnjG3ACTDOPvY5571vuqNvjzu6e4zu/2P2nGvVljY+Pm/f0R/mWLWrdqhdUv32fJ71rLU8/kt3wbMwGc6iVHje/TOl/ZPHbBdnUDvhWcL3WJIFJ8CrbCrnH+TxVRD3BeY+uU8KzDKaeC8+NsoeP2aOB7qvX5oHz7J8eJZTwYXwhJTAE1YGz8pyeMKlCm6XwfE+jqyEZ1UVPKtr4FnTCM/aJkrtbjhrG9g22HYd921ogWc9t9fUUbXwRPM10WzX7KYabBvFx6uq4UTyPSP4WRFl5vPsZ1MrK+CEV5r2SVVa6VhENd+jnufUYM+JcqK5vYrvH1Fjnx9abr/bimJ+X37PoDzz/Z9QEK/H8gJehy0TMEVgHCddAWr5EpHBK5ygmqNC7TrXKHkGLTGFYp17lBu9IZqixRqQkpMMP/wwVsk0JrLoLMIhGFrEAy2KujtNTAIIQh31CHSWY9oJt7FgESPcCR7RgEpCwQ0FARDKrlXqCRgAqxw6oXJtJLbMBSYKRqx1Yzhn8d8qwQcs1S5p3IrjkAl5udvMirAS05KvyGZ5bgGtlPu6jkTmtpr1J4WvbTUzuy/fiZ5Ii8ymSyk8Z35sj/xv/L8sHCK6iGp3GAAAAAElFTkSuQmCC",
    "cutImage": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAADEAAAAxCAYAAABznEEcAAAZA0lEQVR42s15Z1dU27ZtX6tyoIoqcgZFERBEFBUwISKZIuecQUBFMICCkjOYUEzbcE67Z+99zr3t3j9zf854fa5i7/3a/fBae+/T+9DbmGuu1PsYfcy1VhWyix8h9dZjnCBiCD9hL3oE7eYscH0W2g1CxWszQOE0tMIHwNVpjhnz70PPn4J+ZYLjSeAa50ufI6x6Gc7qFaBqGVrjJkzte/B2vkJmxz5SW7fhatuHxm197BO0yV+A4SNovW85dwC07kBr3uR5G0DDGrTaVSCwzGu9gFb6DNrtp0DxE8YngALHuFUyi5LSRyg9g1/hDbKY3mOphqezW+d/g7bg28wjR4Z4pUIrY0imjfgbFhFUv0yChpXcal2CYlVtNXu0yPML/xE//I/0Lj6OzuRtNED9L7RAz3HpNUf8S08pmUdWsOqAb1xzZjTmvicuHfvA4Zmf0ETRVTd+4hyklXkT5N4EkmeZZbPkmAmiaUTUayAl9GpHmIkbzWaNygChgBlozeGjYxIEYqcpv4wJKytW/BRiEfZR4lgP+i0k94RzK7GedW0Kuv6H5lXAts2ucRSSDPJN3G5baYg47xt/C/LhN3sJcF5bwAAAABJRU5ErkJggg==",
    "pointY": 55,
    "token": "x7QLcizPl2eAaNdKChs2XnbrbEMHuF1dy",
    "expire": 60
}

错误码

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