Коды ошибок

Описание кодов ошибок 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, то необходимо подождать несколько секунд и повторить запрос. Вы также можете залогировать данные вашего запроса и ответ для целей отладки, эта информация может быть полезна при обращении в нашу службу поддержки.