UNLOCK API
Коды ошибок

Коды ошибок

Методы JSON возвращают errorId 1 с errorCode и errorDescription. in.php и res.php возвращают название ошибки текстом или {"status":0,"request":"ERROR_NAME"} с json=1. HTTP-статус в обоих случаях 200, поэтому всегда читайте тело ответа.

Ключ, аккаунт и лимиты

  • ERROR_KEY_DOES_NOT_EXIST
    Где возвращается: JSONНе списывается

    Неверный ключ. Скопируйте его заново со страницы аккаунта. (in.php и res.php: ERROR_WRONG_USER_KEY)

  • ERROR_WRONG_USER_KEY
    Где возвращается: in.php, res.phpНе списывается

    in.php и res.php: неверный ключ. Скопируйте его заново со страницы аккаунта.

  • ERROR_IP_NOT_ALLOWED
    Где возвращается: ОбаНе списывается

    Запрос пришёл с IP, которого нет в списке разрешённых для аккаунта. Добавьте этот IP на странице аккаунта.

  • ERROR_IP_BANNED
    Где возвращается: ОбаНе списывается

    Этот аккаунт заблокирован. Напишите в поддержку со страницы аккаунта.

  • ERROR_ZERO_BALANCE
    Где возвращается: ОбаНе списывается

    На балансе не хватает денег для задачи. Пополните баланс; ничего не списано.

  • ERROR_TOO_MANY_REQUESTS
    Где возвращается: ОбаНе списывается

    Слишком много запросов. Проверяйте результат не чаще раза в 5 секунд.

Задача отклонена при отправке

  • ERROR_TASK_NOT_SUPPORTED
    Где возвращается: JSONНе списывается

    Тип задачи неизвестен или отключён. Проверьте название типа.

  • ERROR_BAD_PARAMETERS
    Где возвращается: ОбаНе списывается

    Обязательное поле отсутствует или имеет неверный формат.

  • ERROR_PAGEURL
    Где возвращается: ОбаНе списывается

    websiteURL или pageurl отсутствует или не является полным адресом http(s).

  • ERROR_GOOGLEKEY
    Где возвращается: in.php, res.phpНе списывается

    В запросе reCAPTCHA через in.php нет googlekey.

  • ERROR_BAD_PROXY
    Где возвращается: ОбаНе списывается

    Задаче с прокси нужны proxyAddress и proxyPort.

  • ERROR_ZERO_CAPTCHA_FILESIZE
    Где возвращается: ОбаНе списывается

    Картинки нет или она слишком маленькая.

  • ERROR_TOO_BIG_CAPTCHA_FILESIZE
    Где возвращается: ОбаНе списывается

    Картинка больше 100 КБ.

  • ERROR_IMAGE_TYPE_NOT_SUPPORTED
    Где возвращается: ОбаНе списывается

    Картинка не является корректным base64.

  • ERROR_NO_SLOT_AVAILABLE
    Где возвращается: ОбаНе списывается

    Сейчас слишком много запросов, поэтому задачу не удалось принять. Попробуйте снова через несколько секунд; ничего не списано.

Проверка результата

  • CAPCHA_NOT_READY
    Где возвращается: in.php, res.phpНе списывается

    Только in.php и res.php: задача ещё выполняется. Проверьте снова через 5 секунд.

  • ERROR_WRONG_CAPTCHA_ID
    Где возвращается: ОбаНе списывается

    В вашем аккаунте нет задачи с таким id.

  • ERROR_WRONG_ID_FORMAT
    Где возвращается: in.php, res.phpНе списывается

    res.php: id отсутствует или не является числом.

  • ERROR_CAPTCHA_UNSOLVABLE
    Где возвращается: ОбаВозвращается

    Задачу не удалось решить вовремя. Деньги за неё вернулись на баланс.

  • ERROR_PROXY_CONNECTION_FAILED
    Где возвращается: ОбаВозвращается

    Решателю не удалось подключиться через ваш прокси. Проверьте, что он работает и логин указан верно.

Задача может не удаться и после того, как её приняли, например если параметры страницы неверны. Тогда getTaskResult возвращает причину в errorCode (один из кодов выше), а деньги уже вернулись на баланс.