Skip to main content

Формат ошибок

Все ошибки возвращаются с соответствующим HTTP-статусом и JSON-телом:

401 — Invalid or missing API key

Проблема с аутентификацией.
Возможные причины:
ПричинаРешение
Заголовок Authorization отсутствуетДобавьте заголовок Authorization: Bearer YOUR_API_KEY
Неверный формат заголовкаУбедитесь в формате Bearer <ключ> (с пробелом после Bearer)
Ключ невалиден или истёкЗапросите новый ключ у администратора
Пример правильного запроса:

404 — No accounts available for this scope

Нет активных тестовых аккаунтов для проверки.
Эта ошибка возникает при вызове POST /api/spam-check/start, если в системе нет доступных Gmail-аккаунтов. Обратитесь к администратору.

404 — Check not found or expired

Проверка не найдена или истекла.
Эта ошибка возникает при вызове GET /api/spam-check/{check_id}. Возможные причины:
ПричинаРешение
Неверный check_idИспользуйте check_id из ответа POST /api/spam-check/start
Проверка истекла (прошло более 10 минут)Создайте новую проверку
Сервер был перезапущенСоздайте новую проверку
Проверки хранятся 5 минут в активном состоянии и 10 минут до полного удаления. Опрашивайте результаты сразу после отправки письма.

Обработка ошибок в коде

Таблица всех ошибок

КодСообщениеЭндпоинтОписание
401Invalid or missing API keyОбаПроблема с API-ключом
404No accounts available for this scopePOST /startНет тестовых аккаунтов
404Check not found or expiredGET /{check_id}Проверка не найдена или истекла