业务容灾方案（Web 及 APP）

业务客户端（前端）容灾

1. 定义错误处理函数。

复制成功
// 错误处理函数作用：在脚本加载或初始化错误时，保障事件流程正常
// 定义验证码js加载错误处理函数
 function loadErrorCallback() {
 var appid = '您的CaptchaAppId';
 // 生成容灾票据或自行做其它处理
 var ticket = 'trerror_1001_' + appid + '_' + Math.floor(new Date().getTime() / 1000);
 callback({
  ret: 0,
  randstr: '@'+ Math.random().toString(36).substr(2),
  ticket: ticket,
  errorCode: 1001,
  errorMessage: 'jsload_error'
 });
 }

2. 验证码返回错误时，调用错误处理函数。

复制成功
try {
 // 生成一个验证码对象
 var captcha = new TencentCaptcha('您的验证码CaptchaAppId', callback, {});
 // 调用方法，显示验证码
 captcha.show(); 
} catch (error) {
 // 加载异常，调用验证码js加载错误处理函数
 loadErrorCallback();
}

3. 回调函数根据 ticket 和 errorCode （而非 ret）的情况做处理。

复制成功
function callback(res) {
 // res（用户主动关闭验证码）= {ret: 2, ticket: null}
 // res（验证成功） = {ret: 0, ticket: "String", randstr: "String"}
 // res（请求验证码发生错误，验证码自动返回trerror_前缀的容灾票据） = {ret: 0, ticket: "String", randstr: "String",  errorCode: Number, errorMessage: "String"}
 if (res.ticket){
     //根据errorCode情况做特殊处理
     if(res.errorCode === xxxxx){
        //自定义容灾逻辑（例如跳过这次验证）
     }
   }
}

说明： ticket：验证成功的票据，当且仅当 ret = 0 时 ticket 有值。 errorCode：错误 code ，详情请参见 回调函数 errorCode 说明。

业务服务端（后端）容灾

• 请求超时或服务未响应。
• 返回异常，Code为InternalError，接口返回举例如下：

复制成功
{
  "Response": {
      "Error": {
          "Code": "InternalError",
          "Message": "An internal error has occurred. Retry your request, but if the problem persists, contact us."
      },
      "RequestId": "xxxxxxxxxxx"
  }
}

• 服务内部错误，CaptchaCode 为26，接口返回举例如下：

复制成功
{
  "Response": {
      "CaptchaCode": 26,
      "CaptchaMsg": "system busy 详情请参考：腾讯云-天御验证码-产品文档，搜索关键字“DescribeCaptchaResult”，查看输出参数中CaptchaCode字段的具体描述",
      "EvilLevel": 0,
      "GetCaptchaTime": 0,
      "RequestId": "xxxxxxxxxxx"
  },
  "retcode": 0,
  "retmsg": "ok"
}