В этом разделе вы найдёте:
Полный список возможных ошибок
Описание каждой ошибки и её причины.
Рекомендации по обработке
Примеры кода для корректной интеграции
Для кого важна эта информация
Разработчики:чтобы правильно обрабатывать исключения и строить логику обработки ошибок на клиентской стороне.
Администраторы:для мониторинга состояния защиты и выявления подозрительных действий.
Безопасникидля анализа попыток обхода защиты и реагирования на атаки.
Что такое ошибки SharkEyes
Ошибки — это стандартные ответы API SharkEyes, возвращаемые в случаях, когда запрос не может быть обработан корректно. Они помогают разработчикам понять, что пошло не так: проблемы с верификацией клиента, некорректные параметры или нарушения правил безопасности.
Какие ошибки обрабатывает API
API возвращает различные типы ошибок, включая сетевые, верификационные и поведенческие. Среди них:
Ошибки идентификации:IP mismatch, UA mismatch, ISS mismatch, AUD mismatch
Ошибки верификации:например, при сбое JS-челленджа или капчи.
Ошибки отсутствия данных:например, no IP detected
Общие ошибки сервера: например, Something went wrong during browser verification.
Основные типы ошибок
SharkEyes классифицирует ошибки по нескольким категориям:
400 Bad Requestнекорректный запрос (отсутствуют обязательные параметры, неверный формат данных).
401 Unauthorizedдоступ запрещён (несоответствие IP/UA/ISS/AUD, сбой верификации браузера).
403 Forbiddenдоступ запрещён (несоответствие IP/UA/ISS/AUD, сбой верификации браузера).
405 Method Not AllowedНедопустимый метод (Использован неподдерживаемый HTTP-метод.).
500 Internal Server Errorвнутренняя ошибка API
429 Too Many RequestsСлишком много запросов (Лимит запросов превышен.).
503 Service Unavailable Сервис недоступен (API временно отключено или находится на обслуживании.)
504 Gateway TimeoutТаймаут (API не ответило вовремя)
Формат ошибок
Ошибки могут возвращаться в двух видах:
Текстовый ответ
"IP mismatch"
→ используется для быстрых проверок.
JSON-ответ
{"status": "error", "reason": "no IP detected"}
→ используется для интеграций, где важно структурированное описание ошибки.
Рекомендации по обработке
Всегда проверяйте HTTP-код в ответе.
Для 400 и 403 ошибок — корректируйте запрос или данные клиента.
Для 500 ошибок — повторите запрос позже или уведомьте администратора.
Логируйте ошибки для анализа (особенно 403, так как это может быть атакой).