后台获取验证码 JS 地址

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

接口描述

协议:HTTPS
域名:csec.api.qcloud.com
接口名:CaptchaIframeQuery
获取验证码的 JavaScript 连接,通过将验证码的 JavaScript 嵌入页面实现验证码的刷新和验证操作。

输入参数

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

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

输出参数

参数名称 类型 描述
code Int 公共错误码,0表示成功,其他值表示失败
详情请参见错误码页面的 公共错误码
codeDesc String 业务侧错误码
成功:返回 Success
错误:返回具体业务错误原因
message String 模块错误信息描述,与接口相关
url String 验证码 JavaScript 地址,该链接单次有效

示例代码

代码下载: JavaPHPPython

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

  • 请求示例:
    https://csec.api.qcloud.com/v2/index.php?Action=CaptchaIframeQuery
    &<公共请求参数>
    &secretId=AKIDmQtAxYTAB2iBS8s2DCzazCD2g7OUq4Zw
    &captchaType=1
    &disturbLevel=1
    &isHttps=1
    &clientType=1
  • 响应示例:
    {
    "code":0,
    "message":"No Error",
    "url":"https://captcha.guard.qcloud.com/template/TCapIframeApi.js?appid=1251001047&clientype=1&lang=2052&asig=-DhJtUkDwLzJpmIfAmasXFn1Y6zCkRQUn8WERrs4lVNmUDcuoDiYYLmoKqd-Ev77Eogpq97Dpb69_MrwGjWXKmTGg9y9iW7wjdriTu_y6WBN4qGsHn6VRk0W1hLB6ZWvqHqw2E5IFCRUcGrHBzMF7A**"
    }