UNLOCK API
Chave de API
Códigos de erro
MarkdownOpenAPI

Códigos de erro

Os métodos JSON retornam errorId 1 com errorCode e errorDescription. in.php e res.php retornam o nome do erro como texto, ou {"status":0,"request":"ERROR_NAME"} com json=1. O status HTTP é 200 nos dois casos, então sempre leia o corpo.

Chave, conta e limites

  • ERROR_KEY_DOES_NOT_EXIST
    Retornado por: JSONSem cobrança

    A chave está errada. Copie de novo na página da conta. (in.php e res.php: ERROR_WRONG_USER_KEY)

  • ERROR_WRONG_USER_KEY
    Retornado por: in.php, res.phpSem cobrança

    in.php e res.php: a chave está errada. Copie-a de novo da página da conta.

  • ERROR_IP_NOT_ALLOWED
    Retornado por: AmbosSem cobrança

    A requisição veio de um IP que não está na lista de permitidos da conta. Adicione o IP na página da conta.

  • ERROR_IP_BANNED
    Retornado por: AmbosSem cobrança

    Esta conta está bloqueada. Fale com o suporte pela página da conta.

  • ERROR_ZERO_BALANCE
    Retornado por: AmbosSem cobrança

    O saldo não cobre a tarefa. Adicione saldo; nada foi cobrado.

  • ERROR_TOO_MANY_REQUESTS
    Retornado por: AmbosSem cobrança

    Muitas requisições. Diminua as consultas de resultado para uma a cada 5 segundos.

Tarefa recusada no envio

  • ERROR_TASK_NOT_SUPPORTED
    Retornado por: JSONSem cobrança

    O tipo de tarefa é desconhecido ou está desativado. Confira o nome do tipo.

  • ERROR_BAD_PARAMETERS
    Retornado por: AmbosSem cobrança

    Falta um campo obrigatório ou ele está no formato errado.

  • ERROR_PAGEURL
    Retornado por: AmbosSem cobrança

    websiteURL ou pageurl está faltando ou não é um endereço http(s) completo.

  • ERROR_GOOGLEKEY
    Retornado por: in.php, res.phpSem cobrança

    Falta googlekey em uma requisição de reCAPTCHA no in.php.

  • ERROR_BAD_PROXY
    Retornado por: AmbosSem cobrança

    Uma tarefa com proxy precisa de proxyAddress e proxyPort.

  • ERROR_ZERO_CAPTCHA_FILESIZE
    Retornado por: AmbosSem cobrança

    A imagem está faltando ou é pequena demais.

  • ERROR_TOO_BIG_CAPTCHA_FILESIZE
    Retornado por: AmbosSem cobrança

    A imagem tem mais de 100 KB.

  • ERROR_IMAGE_TYPE_NOT_SUPPORTED
    Retornado por: AmbosSem cobrança

    A imagem não está em base64 válido.

  • ERROR_NO_SLOT_AVAILABLE
    Retornado por: AmbosSem cobrança

    Muitas requisições agora, então a tarefa não pôde ser aceita. Tente de novo em alguns segundos; nada foi cobrado.

Consulta do resultado

  • CAPCHA_NOT_READY
    Retornado por: in.php, res.phpSem cobrança

    Só in.php e res.php: a tarefa ainda está em andamento. Consulte de novo em 5 segundos.

  • ERROR_WRONG_CAPTCHA_ID
    Retornado por: AmbosSem cobrança

    Não existe tarefa com este id na sua conta.

  • ERROR_WRONG_ID_FORMAT
    Retornado por: in.php, res.phpSem cobrança

    res.php: o id está faltando ou não é um número.

  • ERROR_CAPTCHA_UNSOLVABLE
    Retornado por: AmbosReembolsado

    A tarefa não pôde ser resolvida a tempo. O valor voltou para o seu saldo.

  • ERROR_PROXY_CONNECTION_FAILED
    Retornado por: AmbosReembolsado

    O resolvedor não conseguiu se conectar pelo seu proxy. Verifique se ele está online e se o usuário está correto.

Uma tarefa também pode falhar depois de aceita, por exemplo quando os parâmetros da página estão errados. Nesse caso getTaskResult retorna o motivo como errorCode (um dos códigos acima) e o valor já voltou para o saldo.