Reconocimiento Automático de CAPTCHA vía API de CapMonster Cloud

El reconocimiento de CAPTCHA a través de la API de CapMonster Cloud es el proceso automatizado de reconocer y resolver palabras o símbolos usando interfaces de programación. Con CapMonster Cloud puedes automatizar la resolución de CAPTCHAs y acelerar tu flujo de trabajo.

Cómo Funciona

La API resuelve CAPTCHAs usando el siguiente proceso:

1. Envío de Solicitud

El cliente envía una solicitud al servidor API, proporcionando los datos del CAPTCHA (imagen, claves del sitio, URL).

2. Procesamiento

El servidor API procesa la solicitud, reconoce el CAPTCHA y comienza a resolverlo.

3. Recibir la Solución

El servidor API resuelve el CAPTCHA, permitiendo al cliente continuar con la verificación.

Por Qué Usar una API para Resolver CAPTCHAs

Las APIs (Interfaces de Programación de Aplicaciones) automatizan acciones en sitios web.

Completar formularios de registro

Extraer y copiar datos

Enviar diversos tipos de información a un servidor

Resolución Automática de CAPTCHAs vía API

La API de CapMonster Cloud utiliza solicitudes HTTP estándar con datos en formato JSON.

Direcciones API

createTask
Crea una tarea de resolución de CAPTCHA.
JSON POST
```
https://api.capmonster.cloud/createTask
```
getTaskResult
Verifica el estado de la tarea y obtiene resultados.
JSON POST
```
https://api.capmonster.cloud/getTaskResult
```
getBalance
Recupera el saldo actual de la cuenta.
JSON POST
```
https://api.capmonster.cloud/getBalance
```
getUserAgent
Proporciona los datos más recientes del navegador y sistema operativo.
JSON POST
```
https://capmonster.cloud/api/useragent/actual
```

Algoritmo de resolución de Captcha

Obtención de la clave

Primero, obtén tu clave API única en el panel personal de CapMonster Cloud.

Enviar una solicitud para crear una tarea

Envía una solicitud HTTP POST a la dirección:

https://api.capmonster.cloud/createTask

Incluye tu clave API y los detalles de la tarea en la solicitud.

Así debería verse tu solicitud:

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

El servidor devolverá el identificador del CAPTCHA (taskId) o un código de error si algo sale mal.

Obtención de la respuesta

Después de crear la tarea, envía una solicitud para obtener la respuesta a la dirección:

https://api.capmonster.cloud/getTaskResult

Incluye tu clave API y el identificador de la tarea (taskId).

Así debería verse tu solicitud:

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

El servidor resolverá el captcha o proporcionará información de que la tarea aún está en proceso.

Ejemplo de respuesta:

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

Manejo de errores: Tipos principales e instrucciones de resolución

Errores principales que puedes encontrar:

INVALID KEY

Código de error de la API: ERROR_KEY_DOES_NOT_EXIST

Esta notificación indica que la clave API ingresada es incorrecta o no existe. Verifica si la ingresaste correctamente e inténtalo de nuevo.

NO FUNDS

Código de error de la API: ERROR_ZERO_BALANCE

Esta notificación indica que no tienes suficientes fondos para completar la tarea (es decir, el saldo es cero). Recarga tu cuenta para continuar resolviendo.

BIG IMAGE SIZE

Código de error de la API: ERROR_TOO_BIG_CAPTCHA_FILESIZE

Esta notificación indica que el tamaño del CAPTCHA excede el límite.

ZERO IMAGE SIZE

Código de error de la API: ERROR_ZERO_CAPTCHA_FILESIZE

Esta notificación indica que el tamaño del CAPTCHA que estás subiendo es inferior a 100 bytes.

CAPTCHA ID IS NOT FOUND

Código de error de la API: ERROR_NO_SUCH_CAPCHA_ID, WRONG_CAPTCHA_ID

El CAPTCHA no se encontró en el sistema (no se pudo localizar su ID). El estado del CAPTCHA debe verificarse dentro de los primeros 5 minutos después de la presentación. Asegúrate de verificarlo dentro de este plazo.

CAPTCHA UNSOLVABLE

Código de error de la API: ERROR_CAPTCHA_UNSOLVABLE

Este tipo de CAPTCHA no es compatible con el servicio, o la imagen no contiene una respuesta legible, lo que significa que es ruido. Podría estar dañada o renderizada incorrectamente.

CAPTCHA IS NOT READY

Código de error de la API: CAPTCHA_NOT_READY

El CAPTCHA aún no ha sido resuelto. Espera uno o dos minutos.

REQUEST IS NOT ALLOWED FROM YOUR IP

Código de error de la API: ERROR_IP_NOT_ALLOWED

Esta notificación indica que la solicitud desde esta dirección IP ha sido rechazada. Abre la configuración de tu cuenta personal y agrega tu IP a la lista de permitidos.

IP BANNED

Código de error de la API: ERROR_IP_BANNED

Has excedido el límite de solicitudes con una clave API incorrecta. Verifica la clave e intenta crear la tarea nuevamente.

INCORRECT METHOD

Código de error de la API: ERROR_NO_SUCH_METHOD

El tipo de CAPTCHA (valor del parámetro "type") es incorrecto. Verifica la corrección del método utilizado.

THE TOKEN IS EXPIRED

Código de error de la API: ERROR_TOKEN_EXPIRED

Al reconocer el CAPTCHA, su proveedor notó que el token adicional había expirado. Crea una nueva tarea, obtén un nuevo token e intenta la solicitud nuevamente.

NO FREE SERVERS

Código de error de la API: ERROR_NO_SLOT_AVAILABLE

Todos los servidores están ocupados. Inténtalo de nuevo más tarde.