后台验证票据 API

最近更新时间:2019-02-27 17:18:24

接口描述

协议:HTTPS
域名:csec.api.qcloud.com
接口名:CaptchaCheck
用户输入验证码之后会获取 API 返回的票据,必须将此票据通过本接口进行校验,以确认票据是从安全 API 返回的,否则将可能导致验证码功能被绕过。

输入参数

以下请求参数列表仅列出了接口请求参数,正式调用时需要加上公共请求参数,见 公共请求参数 页面。其中,此接口的 Action 字段为 CaptchaCheck。

参数名称 是否必须 类型 描述
ticket String API 返回给用户的票据
captchaType Int 验证码类型
userIp String 用户操作来源的外网 IP
accountType UInt 用户账号类型
0:其他账号
1:QQ 开放帐号
2:微信开放帐号
4:手机账号
6:手机动态码
7:邮箱账号
appId 否,但建议选择 String accountType 是 QQ 或微信开放账号时,该参数必填,表示 QQ 或微信分配给给网站或应用的 AppID,用来唯一标识网站或应用
businessId UInt 业务 ID,网站或应用在多个业务中使用此服务,通过此 ID 区分统计数据
sceneId UInt 场景 ID,网站或应用的业务下有多个场景使用此服务,通过此 ID 区分统计数据
uid String 用户 ID,accountType 不同对应不同的用户 ID。如果是 QQ 或微信用户则填入对应的 openId
associateAccount String accountType 是 QQ 或微信开放账号时,用于标识 QQ 或微信用户登录后关联业务自身的账号 ID
registerTime UInt 注册时间戳,单位秒
xForwardedFor String 用户 HTTP 请求中的 x_forward_for
macAddress String mac 地址或设备唯一标识
imei String 手机设备号

输出参数

参数名称 类型 描述
code Int 公共错误码,0表示成功,其他值表示失败。详见错误码页面的 公共错误码
codeDesc String 业务侧错误码。成功时返回 Success,错误时返回具体业务错误原因。
message String 模块错误信息描述,与接口相关

示例代码

代码下载: JavaPHPPython

一个完整的请求需要两类请求参数:公共请求参数和接口请求参数。这里只列出了接口请求参数,并未列出公共请求参数,有关公共请求参数的说明可见 公共请求参数

  • 请求示例:
    https://csec.api.qcloud.com/v2/index.php?Action=CaptchaCheck
    &<公共请求参数>
    &ticket=1111
    &captchaType=1
    &disturbLevel=1
    &userIp=127.0.0.1
  • 响应示例
    {
    "code":0,
    "message":"No Error",
    "is_right":0
    }