API 错误清单
这是我们的 API 可能会产生的错误的清单。我们强烈建议开发人员记录并分析所有 API 错误,并准时采取相应行动,例如修复应用中的缺陷,以及在用户中分发更新。我们积极防止我们的 API 收到“荒谬”的请求,例如在反复发出同样的请求时产生同样的错误。这包括 IP 地址和子网封禁,以及在某些严重情况下暂停帐户的使用。
标识符 | 代码 | 说明 |
---|---|---|
0 | 代码 0 用于表示“没有错误”。 | |
1 | ERROR_KEY_DOES_NOT_EXIST | 未在系统中找到帐户授权密钥。请确保已正确地复制该密钥,未复制空格和制表符。 |
2 | ERROR_NO_SLOT_AVAILABLE | 目前没有空闲人机验证工作人员,客户必须在客户区的 API 设置中提高其最高出价,或选择不那么忙的时候创建任务。对于出价如何发挥作用,可在常见问题解答中找到更多相关详细信息。 |
3 | ERROR_ZERO_CAPTCHA_FILESIZE | 正在上传的人机验证谜题小于 100 字节。 |
4 | ERROR_TOO_BIG_CAPTCHA_FILESIZE | 正在上传的人机验证谜题大于 500,000 字节。 |
10 | ERROR_ZERO_BALANCE | 帐户余额为零或负数。 |
11 | ERROR_IP_NOT_ALLOWED | 不许通过您的 IP 地址发出内有当前帐户密钥的请求。请参见客户区内安保设置中的 IP 地址清单。 |
12 | ERROR_CAPTCHA_UNSOLVABLE | 未能由 5 名不同的工作人员破解人机验证谜题。对于这种任务,已向客户收费,因为工作人员已为这些任务耗费时间。 |
12 | ERROR_BAD_DUPLICATES | 100% 识别功能因为未尝试猜测而未发挥作用。 |
14 | ERROR_NO_SUCH_METHOD | 用不存在的方法向 API 发出了请求。程序员输错方法名称时,通常会发生这种情况。 |
15 | ERROR_IMAGE_TYPE_NOT_SUPPORTED | 未能通过人机验证谜题文件的 exif 标头确定这种文件的类型,或者图片类型不受支持。只许使用 JPG、GIF、PNG 这几种格式。图片必须含有 EXIF 标头,其中有图片类型相关信息。 |
16 | ERROR_NO_SUCH_CAPCHA_ID | 您的当前人机验证谜题清单中没有所请求破解的人机验证谜题,或者已将其删除。 工作人员完成任务 60 秒后会从 API 中删除人机验证谜题。在此期间,您的应用必须发送所有任务执行结果轮询请求,以及提供正确/不正确报告的请求。 |
21 | ERROR_IP_BLOCKED | 已因为不当使用 API 而阻止您的 IP 地址。请在此处查看原因。 |
22 | ERROR_TASK_ABSENT | “task”属性是空的或未在 createTask 方法中设置。 |
23 | ERROR_TASK_NOT_SUPPORTED | 任务类型不受支持或输入得不正确。请检查任务对象中的“type”属性。 |
24 | ERROR_INCORRECT_SESSION_DATA | 缺少一些后续用户模拟所需的值。对于缺少的值,API 输出信息中有更多详细信息。 |
25 | ERROR_PROXY_CONNECT_REFUSED | 未能连接到任务的代理服务器,连接已被拒绝。 |
26 | ERROR_PROXY_CONNECT_TIMEOUT | 未能连接到任务的代理服务器,连接已超时。 |
27 | ERROR_PROXY_READ_TIMEOUT | 任务代理服务器读取超时 |
28 | ERROR_PROXY_BANNED | 目标服务已封禁代理服务器 IP 地址。 |
29 | ERROR_PROXY_TRANSPARENT | 任务已在代理服务器检查状态中被拒。代理服务器必须是不透明的代理服务器,才能隐藏我们的服务器 IP 地址。 请用我们的代理服务器检查工具对代理服务器进行调试。 |
30 | ERROR_RECAPTCHA_TIMEOUT | Recaptcha 任务超时,很可能是因为代理服务器或 Google 服务器速度慢 |
31 | ERROR_RECAPTCHA_INVALID_SITEKEY | 人机验证谜题提供者报告说网站密钥无效。 |
32 | ERROR_RECAPTCHA_INVALID_DOMAIN | 人机验证谜题提供者报告说此网站密钥的域无效。 |
33 | ERROR_RECAPTCHA_OLD_BROWSER | 人机验证谜题提供者报告说浏览器用户代理程序与其 JavaScript 不兼容 |
34 | ERROR_TOKEN_EXPIRED | 人机验证谜题提供者的服务器报告说,更多可变标记已过期。请用新标记重试。 |
35 | ERROR_PROXY_HAS_NO_IMAGE_SUPPORT | 代理服务器不支持通过 Google 服务器传输图片数据的操作。 请用我们的代理服务器检查工具对代理服务器进行调试。 |
36 | ERROR_PROXY_INCOMPATIBLE_HTTP_VERSION | 代理服务器不支持长度约为 2000 字节的长 GET 请求,而且不支持 SSL 连接。 请用我们的代理服务器检查工具对代理服务器进行调试。 |
49 | ERROR_PROXY_NOT_AUTHORISED | 代理服务器登录名和密码不正确。 请用我们的代理服务器检查工具对代理服务器进行调试。 |
51 | ERROR_INVALID_KEY_TYPE | 通过的sitekey是来自另一种Recaptcha类型。尝试以V2、V2-invisible或V3来解决。 |
52 | ERROR_FAILED_LOADING_WIDGET | 未能在工作人员的浏览器中加载人机验证谜题提供小组件。请尝试发送新任务。 |
53 | ERROR_VISIBLE_RECAPTCHA | 已尝试将普通 Recaptcha V2 谜题作为不可见 Recaptcha V2 谜题破解。请从 API 有效载荷中删除标志“isInvisible”。 |
54 | ERROR_ALL_WORKERS_FILTERED | 没有未用 reportIncorrectRecaptcha 方法滤掉的工作人员。 |
55 | ERROR_ACCOUNT_SUSPENDED | 系统已由于某个重要原因而暂停您帐户的使用。请联系支持人员了解详情。 |
56 | ERROR_TEMPLATE_NOT_FOUND | 在任务创建过程中,没有找到反关卡模板的名称。 |
57 | ERROR_TASK_CANCELED | 反关卡任务被工作者取消了。取消的原因见 "errorDescription "字段。 |