错误代码和说明

captchaRun

1038字约3分钟

2024-05-21

API错误

此类错误通常发生在未正确调用API，余额不足等。

发生错误时的HTTP状态码为4xx，5xx，你可以使用各语言的http请求是否正常完成的判断方法来检测错误

返回的信息如下

{
  "statusCode":401,
  "message":"Authorization 错误",
  "error":"Unauthorized"
}

请将message返回给用户或是打印到日志中便于排查错误

以下是Python语言处理这类错误的示例代码

import requests

headers = {
    'Authorization': 'Bearer 你的token',
}

response = requests.get('https://api.captcha.run/v2/users/self', headers=headers)
if response.ok:
    print("请求成功")
else:
    print("发生错误")
print(response.json())

验证码识别错误

🔗获取任务结果: /v2/tasks/{taskId}

此类错误通常出现在获取任务结果时，错误代码如下：

errorCode	errorDescription	说明
ERROR_SERVICE_UNAVALIABLE	服务暂时不可用	可能是服务器压力较大，请稍后再试，如果持续出现请联系客服
ERROR_REQUIRED_FIELDS	请检查字段：XXX	缺少字段或者字段错误，请仔细检查
ERROR_THREADS_MAXIMUM	识别任务已达到最大	从任务创建到识别完成为1个并发，超过并发上限会提示此错误
ERROR_PAGE_NOT_FOUND	请求的页面不存在	请求了不存在路径
ERROR_BAD_REQUEST	错误请求	请求出现错误，如果持续出现请联系客服
ERROR_INTERNAL_SERVER_ERROR	服务器内部错误	如果持续出现请联系客服
ERROR_IP_BANNED	你的IP已被屏蔽10分钟	短时间内（1分钟内）出现大量错误（持续达1000次），将会自动屏蔽30分钟，请检查您的错误信息后重试
ERROR_TASKID_INVALID	任务ID不存在或已失效	请求了错误的ID，或者ID已经不存在
ERROR_TASK_TIMEOUT	任务已超时	120秒如果仍未识别成功，则会报超时错误
ERROR_NO_SUCH_METHOD	不支持的请求方法	不支持GET方法，仅支持POST方法提交
ERROR_TASK_NOT_SUPPORTED	任务类型不受支持	验证码类型不正确或尚未支持
ERROR_CAPTCHA_UNSOLVABLE	验证码未能识别	不会扣费，请重试
ERROR_NO_SUCH_CAPCHA_ID	验证码任务已失效	不会扣费，请重试
ERROR_RECAPTCHA_INVALID_SITEKEY	目标网站SITEKEY无效	不会扣费，如果确认SiteKey没错的话，重试即可
ERROR_UNKNOWN_QUESTION	错误的问题ID	请检查问题ID是否正确
ERROR_UNKNOW_450x450_QUESTION	这个尺寸暂时不支持这个问题	暂时不能很好的识别这个问题相关的图片，请重试其他类型的图片
ERROR_IP_BLOCKED_5MIN	由于过多错误请求已被屏蔽	由于过多错误请求已被屏蔽，5分钟后自动解封，请稍后再试。
ERROR_NO_SLOT_AVAILABLE	服务器资源不足，请稍后重试	请延后3秒再重试，不要短时间内大量重复发起请求，会触发自动阻塞机制
ERROR_NO_SLOT_AVAILABLE_BLOCK	服务器资源不足，请等待20秒后重试	1分钟内产生20次以上的ERROR_NO_SLOT_AVAILABLE将会触发自动阻塞，需要等待20秒后才可以继续创建任务
ERROR_RECAPTCHA_INVALID_DOMAIN	域名错误	域名和siteKey不匹配

错误示例如下

{
  "id": "xxxx",
  "account": "xxxxx",
  "price": "0.012",   //价格
  "deducted": false,  //是否扣费
  "captchaType": "ReCaptchaV2",
  "request": {  // 提交的任务信息
    "isInvisible": false,
    "useCache": true,
    "captchaType": "ReCaptchaV2",
    "siteKey": "xxxxx",
    "siteReferer": "xxxxx"
  },
  "reason": "ERROR_RECAPTCHA_INVALID_DOMAIN",  // 错误代码
  "status": "Fail", // 状态
  "finished": "2023-07-27T08:29:49.565Z",
  "created": "2023-07-27T08:29:47.274Z",
  "ip": "xxxx",
  "fromCache": false
}