客户自检当前接入版本
检查客户端(前端),搜索验证码 JS 地址接入域名,对比搜索结果如下:
验证码JS接入域名 | Web客户端 | App客户端 | 小程序插件 | |
ssl.captcha.qq.com | 无需变更 | | ||
t.captcha.qq.com | | | | |
t.captcha.qcloud.com | | | | |
captcha.myqcloud.com | | | | |
captcha.cloudcachetci.com | | | | |
captcha.gtimg.com | | | | |
captcha.guard.qcloud.com | | | | |
captcha.253.com | 无需变更 | 无需变更 | 无需变更 | |
说明:
本次变更仅涉及前端(客户端),未涉及服务端票据校验接口。
Web 客户端接入变更指引
1. 全局搜索验证码相关代码,将代码中涉及的域名:
ssl.captcha.qq.com
t.captcha.qq.com
t.captcha.qcloud.com
captcha.myqcloud.com
captcha.cloudcachetci.com
替换为:
turing.captcha.qcloud.com
。
2. 全局搜索验证码相关代码,将代码中涉及的域名:
captcha.gtimg.com
替换为:
turing.captcha.gtimg.com
。
修改前(以下代码仅为实例,具体实现形式,以客户代码为准,建议全局搜索替换以上域名):
<!DOCTYPE html><html lang="en"><head><meta charset="UTF-8"><meta http-equiv="X-UA-Compatible" content="IE=edge"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>Web 前端接入示例</title><!-- 验证码程序依赖(必须)。请勿修改以下程序依赖,如通过其他手段规避加载,会导致验证码无法正常更新,对抗能力无法保证,甚至引起误拦截。 --><script src="https://ssl.captcha.qq.com/TCaptcha.js"></script></head><body><button id="CaptchaId" type="button">验证</button></body>
修改后(以下代码仅为实例,具体实现形式,以客户代码为准,建议全局搜索替换以上域名):
<!DOCTYPE html><html lang="en"><head><meta charset="UTF-8"><meta http-equiv="X-UA-Compatible" content="IE=edge"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>Web 前端接入示例</title><!-- 验证码程序依赖(必须)。请勿修改以下程序依赖,如通过其他手段规避加载,会导致验证码无法正常更新,对抗能力无法保证,甚至引起误拦截。 --><script src="https://turing.captcha.qcloud.com/TCaptcha.js"></script></head><body><button id="CaptchaId" type="button">验证</button></body>
3. 执行上线前测试,并发布。
App 客户端(Android/iOS)变更指引
1. 全局搜索验证码相关代码,将代码中涉及的域名:
ssl.captcha.qq.com
t.captcha.qq.com
t.captcha.qcloud.com
captcha.myqcloud.com
captcha.cloudcachetci.com
替换为:
turing.captcha.qcloud.com
。
2. 全局搜索验证码相关代码,将代码中涉及的域名:
captcha.gtimg.com
替换为:
turing.captcha.gtimg.com
。
修改前(以下代码仅为实例,具体实现形式,以客户代码为准,建议全局搜索替换以上域名):
<!DOCTYPE html><html lang="en"><head><meta charset="UTF-8"><meta http-equiv="X-UA-Compatible" content="IE=edge"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>Web 前端接入示例</title><!-- 验证码程序依赖(必须)。请勿修改以下程序依赖,如通过其他手段规避加载,会导致验证码无法正常更新,对抗能力无法保证,甚至引起误拦截。 --><script src="https://ssl.captcha.qq.com/TCaptcha.js"></script></head><body><button id="CaptchaId" type="button">验证</button></body>
修改后(以下代码仅为实例,具体实现形式,以客户代码为准,建议全局搜索替换以上域名):
<!DOCTYPE html><html lang="en"><head><meta charset="UTF-8"><meta http-equiv="X-UA-Compatible" content="IE=edge"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>Web 前端接入示例</title><!-- 验证码程序依赖(必须)。请勿修改以下程序依赖,如通过其他手段规避加载,会导致验证码无法正常更新,对抗能力无法保证,甚至引起误拦截。 --><script src="https://turing.captcha.qcloud.com/TCaptcha.js"></script></head><body><button id="CaptchaId" type="button">验证</button></body>
3. 执行上线前测试,并通过对应应用市场发布 App。
历史遗留版本变更指引
检查客户端(前端)代码
旧版验证码拉取 JS 的域名为:
captcha.guard.qcloud.com
。请您检查客户端(前端)代码中是否有以上域名引用,若有相关引用,说明您接入的是旧版验证码。
检查服务端(后端)代码
老版本验证码接口域名:
csec.api.qcloud.com
。老版本验证码接口:
CAPTCHA_CHECK_INTF
CAPTCHA_GET_URL_NEW_INTF
CAPTCHA_QUERYIFRAME_INTF
请您检查服务端(后端)代码中是否有调用以上接口,若有相关调用,说明您接入的是旧版验证码。
接入验证码新版本
步骤1:开通新版本验证码服务
若您未领取验证码免费包,请先领取免费包,然后单击右上角快速咨询,联系我们更改免费包规格。
若您领取过验证码免费包,请单击右上角快速咨询,联系我们更改免费包规格。
步骤2:接入新版本验证码
注意
请完全按照入门文档进行全面接入,旧版本 CaptchaAppId 不可再用,新版本客户端接入方式、服务端接入方式也与旧版本不同。
步骤3:取消旧版本验证码自动续费
1. 若您旧版本验证码开通了自动续费,可进入 续费管理 页面,取消验证码自动续费。