# Diccionario de errores

`errorId` siempre es `0` o `1`. Los valores de `errorCode` forman parte del contrato y **no** se traducen.

| errorCode | Cuándo | Descripción | Acción del cliente |
|---|---|---|---|
| `ERROR_KEY_DOES_NOT_EXIST` | — | El clientKey no es válido o no se encuentra | Comprueba la clave en el portal; no lo reintentes con el mismo valor. |
| `ERROR_ZERO_BALANCE` | — | Saldo de cuenta insuficiente | Deja de crear tareas; compra créditos. Disponible = saldo − congelado. |
| `ERROR_TASK_NOT_SUPPORTED` | — | El tipo de tarea no es compatible | Comprueba la cadena del tipo y si está activado. Un tipo desactivado también devuelve este código. |
| `ERROR_TASK_NOT_ACTIVE` | — | El tipo de tarea no está activo | Se incluye por compatibilidad. El binario actual nunca lo devuelve: los tipos inactivos desaparecen del registro. |
| `ERROR_TASK_DENIED` | — | Creación de tarea denegada | La cuenta está bloqueada. Contacta con soporte. |
| `ERROR_RATE_LIMIT` | — | Se superó el límite de solicitudes | Espera antes de reintentar; el intervalo se aplica por clave API. |
| `ERROR_NO_SLOT_AVAILABLE` | — | No hay capacidad de procesamiento disponible | Inténtalo más tarde. También se utiliza cuando una sesión de Akamai está ocupada. |
| `CAPTCHA_NOT_READY` | — | El resultado de la tarea aún no está listo | Sigue consultando getTaskResult cada 1–2 s. |
| `ERROR_CAPTCHA_UNSOLVABLE` | — | No se pudo resolver el captcha | No repitas solicitudes de pago sin comprobarlas; revisa el sitio y los parámetros. |
| `ERROR_BAD_REQUEST` | — | La solicitud tiene un formato incorrecto | Corrige los campos ausentes, los tipos, la URL/base64 o el tiempo de espera. |
| `ERROR_INTERNAL` | — | Error interno del servidor | Reintenta con esperas progresivas; contacta con soporte si persiste. |
| `ERROR_TASK_NOT_FOUND` | — | No se encontró la tarea | El taskId es incorrecto o pertenece a otra clave. |
| `ERROR_TASK_EXPIRED` | — | La tarea ha caducado | Crea una tarea nueva. También se utiliza cuando una sesión de navegador de Akamai ha caducado. |
| `ERROR_TOO_MANY_REQUESTS` | — | Demasiados intentos de consulta del resultado | Deja de consultar este taskId (límite de 120). |

Source: https://kaptra.ai/es/docs/error-codes/error-dictionary