tencent cloud

验证码

动态与公告
产品动态
产品公告
产品简介
产品概述
产品优势
应用场景
购买指南
接入指引
客户端接入
服务端接入
与 WAF 服务提供方集成
JS 迁移指引
操作指南
验证管理
验证统计
API 文档
History
Introduction
API Category
Making API Requests
Server APIs
Error Codes
业务容灾方案
业务容灾方案(Web 及 APP)
常见问题
计费相关
功能相关
接入相关
相关协议
Service Level Agreement
隐私政策
数据处理和安全协议
联系我们
词汇表

Web 客户端升级指引

PDF
聚焦模式
字号
最后更新时间: 2025-08-27 15:41:45
本文将为您介绍如何将已集成的腾讯云验证码1.0平滑升级到验证码2.0,提升安全性和用户体验。
说明:
为持续提升验证码服务的稳定性与使用体验,我们对验证功能进行了技术升级与优化。新版本 JS 地址https://ca.turing.captcha.qcloud.com/TJNCaptcha-global.js 将在性能支持、功能迭代等方面为您提供更及时、更高效的服务保障。
若当前仍在使用旧版 JS 地址 https://ca.turing.captcha.qcloud.com/TCaptcha-global.js,我们建议您可逐步将业务调用地址切换至新版。
如您在操作过程中有任何疑问,欢迎随时通过 提交工单 与我们联系,我们将及时为您提供支持。

升级客户端

1. 删除验证码1.0的 SDK 资源引用代码。
<script src="https://ca.turing.captcha.qcloud.com/TCaptcha-global.js"></script>
2. 新增验证码2.0的 SDK 资源引用代码。
<script src="https://ca.turing.captcha.qcloud.com/TJNCaptcha-global.js"></script>
3. 删除验证码1.0的初始化代码。
var capctha = new TencentCaptcha('your appid', callback, {});
captcha.show();
4. 新增验证码2.0的初始化代码。
<body>
<!-- Container for package captcha -->
<div id="tcaptcha"></div>
</body>
<script>
var capctha = new TencentCaptcha(document.getElementById("tcaptcha"), 'your appid', callback, {});
captcha.show();
</script>

升级代码示例

验证码1.0接入示例(旧)
验证码2.0接入示例(新)
<html lang="en">
<head>
<script src="https://ca.turing.captcha.qcloud.com/TCaptcha-global.js"></script>
</head>
<script>
// use tencent captcha sdk
var capctha = new TencentCaptcha('your appid', callback, {});
captcha.show();
</script>
</html>
<html lang="en">
<head>
<script src="https://ca.turing.captcha.qcloud.com/TJNCaptcha-global.js"></script>
</head>
<body>
<!-- Container for package captcha -->
<div id="tcaptcha"></div>
</body>
<script>
// use tencent captcha sdk
var capctha = new TencentCaptcha(document.getElementById("tcaptcha"), 'your appid', callback, {});
captcha.show();
</script>
</html>


验证码 SDK 参数对比

验证码初始化时 new TencentCaptcha() 的参数区别详见下表。
SDK 版本/参数说明
第一个参数
第二个参数
第三个参数
第四个参数
验证码1.0
AppId(String)
Callback(Functionn)
Options(Object)
-
验证码2.0
DOM(Element Nodes )
AppId(String)
Callback(Functionn)
Options(Object)

相关文档

完整验证码2.0客户端代码请参见 Web 客户端接入
更多验证码 SDK 参数说明请参见 接入说明

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈