UNLOCK API
Códigos de error

Códigos de error

Los métodos JSON devuelven errorId 1 con errorCode y errorDescription. in.php y res.php devuelven el nombre del error como texto, o {"status":0,"request":"ERROR_NAME"} con json=1. El estado HTTP es 200 en ambos casos, así que lee siempre el cuerpo.

Clave, cuenta y límites

  • ERROR_KEY_DOES_NOT_EXIST
    Lo devuelve: JSONSin cobro

    La clave es incorrecta. Cópiala de nuevo desde la página de cuenta. (in.php y res.php: ERROR_WRONG_USER_KEY)

  • ERROR_WRONG_USER_KEY
    Lo devuelve: in.php, res.phpSin cobro

    in.php y res.php: la clave es incorrecta. Cópiala de nuevo desde la página de cuenta.

  • ERROR_IP_NOT_ALLOWED
    Lo devuelve: AmbosSin cobro

    La solicitud vino de una IP que no está en la lista de permitidas de la cuenta. Agrega la IP en la página de cuenta.

  • ERROR_IP_BANNED
    Lo devuelve: AmbosSin cobro

    Esta cuenta está bloqueada. Contacta con soporte desde la página de cuenta.

  • ERROR_ZERO_BALANCE
    Lo devuelve: AmbosSin cobro

    El saldo no alcanza para la tarea. Agrega fondos; no se cobró nada.

  • ERROR_TOO_MANY_REQUESTS
    Lo devuelve: AmbosSin cobro

    Demasiadas solicitudes. Espacia las consultas de resultado a una cada 5 segundos.

Tarea rechazada al enviarla

  • ERROR_TASK_NOT_SUPPORTED
    Lo devuelve: JSONSin cobro

    El tipo de tarea es desconocido o está desactivado. Revisa el nombre del tipo.

  • ERROR_BAD_PARAMETERS
    Lo devuelve: AmbosSin cobro

    Falta un campo obligatorio o tiene un formato incorrecto.

  • ERROR_PAGEURL
    Lo devuelve: AmbosSin cobro

    Falta websiteURL o pageurl, o no es una dirección http(s) completa.

  • ERROR_GOOGLEKEY
    Lo devuelve: in.php, res.phpSin cobro

    Falta googlekey en una solicitud de reCAPTCHA a in.php.

  • ERROR_BAD_PROXY
    Lo devuelve: AmbosSin cobro

    Una tarea con proxy necesita proxyAddress y proxyPort.

  • ERROR_ZERO_CAPTCHA_FILESIZE
    Lo devuelve: AmbosSin cobro

    Falta la imagen o es demasiado pequeña.

  • ERROR_TOO_BIG_CAPTCHA_FILESIZE
    Lo devuelve: AmbosSin cobro

    La imagen pesa más de 100 KB.

  • ERROR_IMAGE_TYPE_NOT_SUPPORTED
    Lo devuelve: AmbosSin cobro

    La imagen no es un base64 válido.

  • ERROR_NO_SLOT_AVAILABLE
    Lo devuelve: AmbosSin cobro

    Hay demasiadas solicitudes en este momento, por eso no se pudo aceptar la tarea. Inténtalo de nuevo en unos segundos; no se cobró nada.

Consulta del resultado

  • CAPCHA_NOT_READY
    Lo devuelve: in.php, res.phpSin cobro

    Solo in.php y res.php: la tarea sigue en curso. Vuelve a consultar en 5 segundos.

  • ERROR_WRONG_CAPTCHA_ID
    Lo devuelve: AmbosSin cobro

    No hay ninguna tarea con este id en tu cuenta.

  • ERROR_WRONG_ID_FORMAT
    Lo devuelve: in.php, res.phpSin cobro

    res.php: falta el id o no es un número.

  • ERROR_CAPTCHA_UNSOLVABLE
    Lo devuelve: AmbosReembolsado

    La tarea no se pudo resolver a tiempo. Su cobro ya volvió a tu saldo.

  • ERROR_PROXY_CONNECTION_FAILED
    Lo devuelve: AmbosReembolsado

    El resolvedor no pudo conectarse a través de tu proxy. Comprueba que esté en línea y que el usuario sea correcto.

Una tarea también puede fallar después de ser aceptada, por ejemplo cuando los parámetros de la página son incorrectos. getTaskResult devuelve entonces el motivo como errorCode (uno de los códigos de arriba) y el cobro ya volvió al saldo.