Коды ошибок
Что означает каждый ответ API и что с ним делать.
Ошибка приходит в том же формате, что и обычный ответ: status равен 0, а в response — код ошибки.
{
"status": 0,
"response": "ERROR_ZERO_BALANCE"
}
За задачи, которые завершились ошибкой, деньги не списываются.
Любой запрос
ERROR_KEY_DOES_NOT_EXISTКлюч не передан, передан не в формате UUID или такого ключа нет.
→ Проверьте заголовок X-API-Key. Ключ — в кабинете, на странице «Обзор».
ERROR_IP_NOT_ALLOWEDУ ключа включён белый список IP, а запрос пришёл с адреса не из него.
→ Добавьте адрес в белый список или удалите все записи, чтобы снять ограничение.
BAD_JSONТело запроса — не корректный JSON.
→ Проверьте тело и заголовок Content-Type: application/json.
ERROR_SERVERВнутренняя ошибка сервиса.
→ Повторите запрос через несколько секунд. Если повторяется — напишите в поддержку.
route-not-foundЗапрос на несуществующий адрес.
→ Проверьте адрес: задачи создаются на /create, результат — на /result.
Создание задачи — /create
Запрос и аккаунт
ERROR_TASK_ABSENTНе передан параметр type.
→ Укажите тип задачи.
ERROR_TASK_NOT_SUPPORTEDТип в type не поддерживается.
→ Проверьте написание: SmartCaptcha, PazlCaptcha, PazlCaptchaV2, TextCaptcha.
ERROR_ZERO_BALANCEНа балансе не больше цены одного решения.
ERROR_USER_DISABLEDАккаунт отключён.
→ Напишите в поддержку.
ERROR_SOFT_NOT_SUPPORTEDДля приложения из app_id этот тип задач отключён.
→ Проверьте app_id или отправляйте задачу без него.
ERROR_TASK_LOOP_DETECTEDОдну и ту же капчу с одного IP приняли в работу 10 раз за 5 минут, и ни разу не забрали её решение. Следующие повторы этой капчи с этого IP блокируются на 15 минут. Повторы с разных серверов считаются отдельно, отклонённые запросы — например, с ERROR_ZERO_BALANCE — не считаются вовсе.
→ Забирайте результат через /result, прежде чем отправлять ту же капчу снова. Проверьте, не зациклился ли ваш код.
Картинки
ERROR_EMPTY_BODYНе переданы картинки: для SmartCaptcha — click и task, для PazlCaptchaV2 — image и task, для остальных — task.
→ Передайте все обязательные поля из раздела про ваш тип капчи.
ERROR_IMAGE_TYPE_NOT_SUPPORTEDКартинка не в формате PNG или JPEG — или к base64 приклеен префикс data:image/...;base64,.
→ Отправляйте исходную картинку с сайта без конвертации, только сам base64.
ERROR_INVALID_IMAGE_DATAСтрока base64 не раскодировалась в целую картинку.
→ Проверьте, что картинка скачана целиком и закодирована без потерь.
ERROR_INVALID_BODY · ERROR_BODY_NOT_BASE64PazlCaptcha: task — не строка или не base64.
→ Передайте HTML страницы строкой в base64.
ERROR_BODY_TOO_LARGE_B64 · ERROR_BODY_TOO_LARGE_RAWКартинка больше 2 МБ — в виде base64 или после раскодирования.
→ Отправляйте картинку капчи, а не скриншот страницы.
ERROR_DUPLICATE_DATASmartCaptcha: в click и task одна и та же картинка.
→ В click — картинка капчи, в task — полоса с заданием.
Решатели
ERROR_NO_ACTIVE_SERVERTextCaptcha: сейчас нет свободных решателей.
→ Повторите через несколько секунд.
CAPCHA_NOT_AVAILABLEЗадачу не удалось поставить в работу.
→ Повторите создание задачи.
Получение результата — /result
CAPCHA_NOT_READYЗадача ещё решается. Это не ошибка.
→ Подождите 2–10 секунд и повторите запрос.
CAPCHA_NOT_AVAILABLEКапчу решить не удалось. Деньги не списаны.
→ Создайте новую задачу.
ERROR_INVALID_TASK_IDid не передан или не в формате UUID.
→ Передайте идентификатор из ответа /create.
ERROR_NO_SUCH_TASK_IDЗадачи с таким id нет у этого ключа — или срок её хранения истёк.
→ Проверьте id и ключ. Забирайте результат вскоре после создания задачи.