Формат ошибок
Все ошибки возвращаются с соответствующим 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 минут до полного удаления. Опрашивайте результаты сразу после отправки письма.
Обработка ошибок в коде
Таблица всех ошибок
| Код | Сообщение | Эндпоинт | Описание |
|---|
401 | Invalid or missing API key | Оба | Проблема с API-ключом |
404 | No accounts available for this scope | POST /start | Нет тестовых аккаунтов |
404 | Check not found or expired | GET /{check_id} | Проверка не найдена или истекла |