工作原理为什么要使用 API 来识别验证码通过 API 自动解决 CAPTCHA 错误处理：主要类型和故障排除说明

通过 CapMonster Cloud API 自动识别 CAPTCHA

使用 CapMonster Cloud API 识别验证码，是通过编程接口自动识别并识别验证码的过程。借助 CapMonster Cloud，您可以自动绕过 CAPTCHA，简化并加快工作流程。

工作原理

API 的验证码识别流程如下：

1. 提交请求

客户端向 API 服务器发送请求，提供 CAPTCHA 数据（图片、网站密钥、网址）。

2. 处理请求

API 服务器处理请求，识别 CAPTCHA 并开始解决过程。

3. 获取结果

API 服务器完成验证码识别，允许客户端继续其验证流程。

为什么要使用 API 来识别验证码

API（应用程序编程接口）可以自动化网站上的操作。

填写注册表单

提取和复制数据

向服务器发送各种类型的信息

通过 API 自动解决 CAPTCHA

CapMonster Cloud API 使用标准 HTTP 请求，并以 JSON 格式发送数据。

API 地址

createTask
创建 CAPTCHA 识别任务。
JSON POST
```
https://api.capmonster.cloud/createTask
```
getTaskResult
检查任务状态并获取结果。
JSON POST
```
https://api.capmonster.cloud/getTaskResult
```
getBalance
获取当前账户余额。
JSON POST
```
https://api.capmonster.cloud/getBalance
```
getUserAgent
提供最新的浏览器和操作系统数据。
JSON POST
```
https://capmonster.cloud/api/useragent/actual
```

验证码解决算法

获取密钥

首先，在 CapMonster Cloud 个人仪表板中获取您的唯一 API 密钥。

发送请求以创建任务

向以下地址发送 HTTP POST 请求：

https://api.capmonster.cloud/createTask

在请求中包含您的API密钥和任务详情。

您的请求应如下所示：

{
  "clientKey":"API_KEY",
  "task": {
    "type":"RecaptchaV2TaskProxyless",
    "websiteURL":"https://example.com/",
    "websiteKey":"6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd"
  }
}

服务器将返回验证码标识符（taskId）或错误代码（如果出现问题）。

获取响应

创建任务后，向以下地址发送请求以获取响应：

https://api.capmonster.cloud/getTaskResult

包含您的 API 密钥和任务标识符（taskId）。

您的请求应如下所示：

{
  "clientKey":"API_KEY",
  "taskId":12345678
}

服务器将解决验证码或提供任务仍在进行中的信息。

响应示例：

{
  "errorId":0,
  "status":"ready",
  "solution": {
    "gRecaptchaResponse":"response_token" 
  }
}

错误处理：主要类型和故障排除说明

您可能遇到的主要错误：

INVALID KEY

API 错误代码： ERROR_KEY_DOES_NOT_EXIST

此通知表示输入的 API 密钥不正确或不存在。请检查您是否输入正确并重试。

NO FUNDS

API 错误代码： ERROR_ZERO_BALANCE

此通知表示您的账户余额不足以完成任务（即余额为零）。请充值您的账户以继续解决验证码。

BIG IMAGE SIZE

API 错误代码： ERROR_TOO_BIG_CAPTCHA_FILESIZE

此通知表示验证码大小超出限制。

ZERO IMAGE SIZE

API 错误代码： ERROR_ZERO_CAPTCHA_FILESIZE

此通知表示您上传的验证码大小小于100字节。

CAPTCHA ID IS NOT FOUND

API 错误代码： ERROR_NO_SUCH_CAPCHA_ID, WRONG_CAPTCHA_ID

系统中未找到验证码（无法定位其ID）。验证码状态应在提交后的前5分钟内检查。请确保在此时间范围内检查。

CAPTCHA UNSOLVABLE

API 错误代码： ERROR_CAPTCHA_UNSOLVABLE

此类型的验证码不受服务支持，或者图像不包含可读的答案，意味着它是噪声。图像可能已损坏或渲染不正确。

CAPTCHA IS NOT READY

API 错误代码： CAPTCHA_NOT_READY

验证码尚未解决。请等待一两分钟。

REQUEST IS NOT ALLOWED FROM YOUR IP

API 错误代码： ERROR_IP_NOT_ALLOWED

此通知表示来自此 IP 地址的请求被拒绝。请打开您的个人账户设置并将您的 IP 添加到允许列表。

IP BANNED

API 错误代码： ERROR_IP_BANNED

您使用错误的 API 密钥超出了请求限制。请检查密钥并尝试重新创建任务。

INCORRECT METHOD

API 错误代码： ERROR_NO_SUCH_METHOD

验证码类型（“type” 参数的值）不正确。请检查使用的方法是否正确。

THE TOKEN IS EXPIRED

API 错误代码： ERROR_TOKEN_EXPIRED

在识别验证码时，服务提供商注意到附加令牌已过期。请创建新任务，获取新令牌并重试请求。

NO FREE SERVERS

API 错误代码： ERROR_NO_SLOT_AVAILABLE

所有服务器均繁忙。请稍后再试。

INVALID RECAPTCHA SITEKEY

API 错误代码： ERROR_RECAPTCHA_INVALID_SITEKEY

提供了错误的 reCAPTCHA 密钥。请检查站点密钥的正确性。

RECAPTCHA TIMEOUT

API 错误代码： ERROR_RECAPTCHA_TIMEOUT

此通知表示解决 reCAPTCHA 的执行时间超过了服务器设置的允许时间，任务无法在指定时间内完成。请稍后重新提交请求。

YOUR IP IS BLOCKED

API 错误代码： ERROR_IP_BLOCKED

由于大量错误，指定IP地址的访问被禁止。请检查您的请求频率。更换您的 IP。创建任务时请考虑限制。

FAILED TO CONNECT PROXY

API 错误代码： ERROR_PROXY_CONNECT_REFUSED

服务无法通过指定的代理服务器建立连接。请检查代理设置（IP、端口、登录名、密码）的正确性和可用性。使用另一个代理。

THE PROXY IP IS BANNED

API 错误代码： ERROR_PROXY_BANNED

代理因其IP被目标验证码服务禁止。请使用另一个代理。

ERROR_TASK_ABSENT

API 错误代码： ERROR_TASK_ABSENT

未找到任务对象，或发送了无效的 JSON。请确保一切正确。检查任务执行时间是否已过期。

请始终参考文档，仅使用最新的 API 参数和方法。

重要！遇到其他错误且不知道如何解决？请参考以下指南以帮助解决问题： https://docs.capmonster.cloud/zh/docs/api/api-errors/。