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