tencent cloud

JS 迁移指引
下载PDF
最后更新时间：2025-09-16 17:58:22
JS 迁移指引
最后更新时间： 2025-09-16 17:58:22
下载PDF

客户自检当前接入版本

检查客户端（前端），搜索验证码动态 JS 接入地址域名，对比搜索结果如下：
验证码 JS 接入域名
Web 和 App 客户端-H5接入
是否需要变更
sg.captcha.qcloud.com
Web 和 App 客户端-H5接入变更指引
需要变更
global.captcha.gtimg.com
需要变更

Web 和App客户端-H5接入变更指引

1. 全局搜索验证码相关代码，将代码中涉及的接入 JS：
https://sg.captcha.qcloud.com/TCaptcha-global.js
或
https://global.captcha.gtimg.com/TCaptcha-global.js
替换为：
https://ca.turing.captcha.qcloud.com/TJNCaptcha-global.js
2. 仅为示例，具体实现请以您的代码为准，建议全局搜索并替换上述域名。
 修改前
<html lang="en">
  <head>
    <script src="https://sg.captcha.qcloud.com/TCaptcha-global.js"></script>
  </head>
  <body></body>
  <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>
3. 验证码接入参数对比
验证码初始化时 new TencentCaptcha() 的参数区别详见下表：
接入版本
接入版本/参数说明
第一个参数
第二个参数
第三个参数
第四个参数
旧域名版本
https://sg.captcha.qcloud.com/TCaptcha-global.js
AppId(String)
Callback(Function)
Options(Object)
-
新域名版本
https://ca.turing.captcha.qcloud.com/TJNCaptcha-global.js
DOM(Element Nodes )
AppId(String)
Callback(Function)
1. Options(Object)
4. 执行上线前测试，并发布。

服务端票据校验指引

1. 服务端自查票据校验接入情况，全局搜索接入 host：
captcha.intl.tencentcloudapi.com
若未通过上述 host 接入后端票据校验，则需进行第二步指引接入。
2. 服务端需调用票据校验 API，对客户端验证结果进行二次校验，操作指引请参见 接入票据校验（Web 及 App）。

本页内容是否解决了您的问题？
您也可以 联系销售 或 提交工单 以寻求帮助。
是
否

文档反馈