Логотип «GitHub»

Коды ошибок

Описание кодов ошибок API

В случае, если что-то не так с вашим запросом или задачей, наш API возвращает код ошибки. Ниже вы можете найти полный список кодов ошибок нашего API.

Id Код ошибки Описание
0 - Ошибка отсутствует
1 ERROR_KEY_DOES_NOT_EXIST Ваш API-ключ неверен. Убедитесь, что вы правильно установили ключ и скопировали его из кабинета в режиме Заказчик или Разработчик
2 ERROR_NO_SLOT_AVAILABLE Ваша ставка слишком мала для отправленной вами капчи, или очередь ваших капч слишком длинная, и мы временно не принимаем от вас больше капч
3 ERROR_ZERO_CAPTCHA_FILESIZE Размер изображения составляет менее 100 байт
4 ERROR_TOO_BIG_CAPTCHA_FILESIZE Размер изображения превышает 100 Кб или изображение больше 600 пикселей с любой стороны
10 ERROR_ZERO_BALANCE У вас нет средств на вашем счете
11 ERROR_IP_NOT_ALLOWED Запрос отправляется с IP-адреса, которого нет в списке ваших доверенных IP-адресов
12 ERROR_CAPTCHA_UNSOLVABLE Мы не можем разгадать вашу капчу - трое наших сотрудников не смогли ее разгадать. Стоимость капчи автоматически возвращается на ваш баланс
13 ERROR_BAD_DUPLICATES Ошибка возвращается, когда включена функция 100% Распознавание. Ошибка означает, что достигнуто максимальное количество попыток, но минимальное количество совпадений не достигнуто
14 ERROR_NO_SUCH_METHOD Запрос, отправленный в API с помощью метода, который не существует
15 ERROR_IMAGE_TYPE_NOT_SUPPORTED Изображение не может быть обработано из-за неправильного формата или размера, или изображение повреждено. Пожалуйста, проверьте отправляемое изображение
16 ERROR_NO_SUCH_CAPCHA_ID Вы указали неверный идентификатор taskId в запросе
21 ERROR_IP_BLOCKED Ваш IP-адрес заблокирован из-за неправильного использования API
22 ERROR_TASK_ABSENT Cвойство task отсутствует в вашем вызове метода createTask
23 ERROR_TASK_NOT_SUPPORTED Свойство task в вашем вызове метода createTask содержит тип задачи, который не поддерживается нашим API, или у вас ошибка в свойстве type.
31 ERROR_RECAPTCHA_INVALID_SITEKEY Значение sitekey, указанное в вашем запросе, недействительно
55 ERROR_ACCOUNT_SUSPENDED Ваш доступ к API был заблокирован за ненадлежащее использование API. Пожалуйста, свяжитесь с нашей службой поддержки, чтобы решить проблему
130 ERROR_BAD_PROXY Неверные параметры прокси-сервера или не удается установить соединение через прокси-сервер
110 ERROR_BAD_PARAMETERS Требуемые параметры капчи в вашем запросе отсутствуют или имеют неправильный формат. Пожалуйста, убедитесь, что ваш запрос имеет правильный формат для выбранного типа задачи
115 ERROR_BAD_IMGINSTRUCTIONS Ошибка возвращается в случаях, когда imgInstructions содержит неподдерживаемый тип файла, поврежденный файл, либо размер файла или изображения превышает лимиты. Лимиты описаны в спецификации соответствующего типа задачи

Коды HTTP-ответов

Если наш API способен должным образом обрабатывать ваши запросы, код статуса ответа всегда будет 200 OK.

Но в случае возникновения какой-либо технической проблемы, сбоя или неработоспособности, на ваш запрос может быть получен server error response или для неправильно сформированного запроса вы можете получить client error response.

Мы рекомендуем вам проверять статус код для каждого ответа, и если статус код не 200 OK, то необходимо подождать несколько секунд и повторить запрос. Вы также можете залогировать данные вашего запроса и ответ для целей отладки, эта информация может быть полезна при обращении в нашу службу поддержки.