Skip to content

校验图形验证码接口

滑动图形验证码滑块后,调用校验图形验证码接口。

请求说明

请求头

参数名中文名称必须类型描述
X-operating-sys-version调用方操作系统版本Stringwindows10.1.1
X-device-fingerprint调用方设备指纹String156aysdna213sc50
X-device-ip调用方IPString192.168.1.2
X-agentUser-Agent信息StringMozilla/5.0 (iPhone; CPU iPhone OS 13_3 like Mac OS X) AppleWebKit/605.1.15(KHTML, like Gecko) Mobile/15E148/HuaWei-AnyOffice/2.6.1802.0010/com.huawei.cloudlink.workplace
X-L用于国际化语言设置Stringzh
X-client-id应用授权IDStringnTo1eRIub60vPb54WeE6aojPwYwImtl4

请求示例

json
#用于发送手机验证码场景
{
  "point_json": "{\"x\":237.0,\"y\":5.0}",
  "token": "71dd26999e314f9abb0c635336976635",
  "sender":"15201657315"
}
#用于发送邮箱验证码场景
{
  "point_json": "{\"x\":237.0,\"y\":5.0}",
  "token": "71dd26999e314f9abb0c635336976635",
  "sender":"zhangsan@qq.com"
}

请求参数

参数名中文名称必须类型描述
point_json坐标信息String坐标信息,y轴固定值5.0
获取坐标信息请参考JS、VUE拼图验证码 DEMO
token获取图形验证码返回的tokenString获取图形验证码返回的token
sender发送方String发送方(手机号、邮箱)

返回示例

成功示例

HTTP/1.1 200 OK

json
{
    "captcha_token":"71dd26999e314f9abb0c635336976635---{\"x\":237.0,\"y\":5.0}"
}

错误示例

HTTP/1.1 400 Bad Request

json
{
    "error_code": "SDK.COMMON.1001",
    "error_msg": "Parameter X-client-id cannot be left blank."
}

返回参数

参数名中文名称类型描述
captcha_token图形验证码校验成功的TokenString图形验证码校验成功的Token

竹云IDaaS开放平台