# Dicionário de erros

`errorId` é sempre `0` ou `1`. Os valores de `errorCode` fazem parte do contrato e **não** são traduzidos.

| errorCode | Quando | Descrição | Ação do cliente |
|---|---|---|---|
| `ERROR_KEY_DOES_NOT_EXIST` | — | O clientKey é inválido ou não foi encontrado | Confira a chave no portal. Não tente novamente com o mesmo valor. |
| `ERROR_ZERO_BALANCE` | — | Saldo da conta insuficiente | Pare de criar tarefas e compre créditos. Disponível = saldo − congelado. |
| `ERROR_TASK_NOT_SUPPORTED` | — | O tipo de tarefa não é compatível | Confira o nome do tipo e se ele está ativado. Um tipo desativado também retorna este código. |
| `ERROR_TASK_NOT_ACTIVE` | — | O tipo de tarefa não está ativo | Listado por compatibilidade. O executável atual nunca o retorna: tipos inativos são removidos do registro. |
| `ERROR_TASK_DENIED` | — | Criação de tarefa negada | A conta está bloqueada. Fale com o suporte. |
| `ERROR_RATE_LIMIT` | — | Limite de solicitações excedido | Aguarde antes de tentar novamente. A janela se aplica a cada chave de API. |
| `ERROR_NO_SLOT_AVAILABLE` | — | Nenhuma posição de processamento disponível | Tente novamente mais tarde. Também usado quando uma sessão Akamai está ocupada. |
| `CAPTCHA_NOT_READY` | — | O resultado da tarefa ainda não está pronto | Continue consultando getTaskResult a cada 1–2s. |
| `ERROR_CAPTCHA_UNSOLVABLE` | — | Falha ao resolver o captcha | Não repita tentativas que possam gerar cobrança sem verificar. Examine o site e os parâmetros. |
| `ERROR_BAD_REQUEST` | — | Solicitação malformada | Corrija campos ausentes, tipos, URL/base64 ou tempo limite. |
| `ERROR_INTERNAL` | — | Erro interno do servidor | Tente novamente com intervalos crescentes. Se persistir, fale com o suporte. |
| `ERROR_TASK_NOT_FOUND` | — | Tarefa não encontrada | O taskId está incorreto ou pertence a outra chave. |
| `ERROR_TASK_EXPIRED` | — | A tarefa expirou | Crie uma nova tarefa. Também usado quando uma sessão de navegador Akamai expira. |
| `ERROR_TOO_MANY_REQUESTS` | — | Excesso de tentativas de consulta do resultado | Pare de consultar este taskId. O limite é 120. |

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