Коди помилок

Супроводжує: команда Aether365 Аудиторія: розробники та ІТ-адміністратори Обсяг: повний довідник кодів помилок API Aether365

Усі помилки API повертають узгоджену структуру JSON:

{
  "success": false,
  "error": {
    "code": "SNAKE_CASE_ERROR_CODE",
    "message": "Human-readable description",
    "details": {}
  }
}

Автентифікація

Код	HTTP	Значення	Виправлення
AUTH_MISSING_TOKEN	401	У запиті немає заголовка Authorization	Додавайте Authorization: Bearer <token> до кожного запиту
AUTH_INVALID_TOKEN	401	Не вдалося перевірити JWT	Переконайтеся, що токен не пошкоджений і не обрізаний
AUTH_EXPIRED_TOKEN	401	Термін дії JWT минув	Отримайте новий токен, увійшовши знову або оновивши сесію
AUTH_INSUFFICIENT_SCOPE	403	Автентифікований обліковий запис не має дозволу на цю дію	Переконайтеся, що ви використовуєте обліковий запис із потрібною роллю

Авторизація

Код	HTTP	Значення	Виправлення
TENANT_ACCESS_DENIED	403	Запит спробував отримати доступ до даних іншого тенанта	Цього ніколи не повинно ставатися за звичайного використання - зверніться до підтримки, якщо ви це бачите
AUTH_INSUFFICIENT_SCOPE	403	Недостатньо дозволів для цієї дії	Переконайтеся, що ви використовуєте обліковий запис із потрібною роллю

Тенант

Код	HTTP	Значення	Виправлення
TENANT_NOT_FOUND	404	Для цього користувача не існує облікового запису тенанта	Створіть обліковий запис на app.aether365.io
TENANT_NOT_CONNECTED	400	Згоду адміністратора Microsoft 365 не було завершено	Підключіть тенант через Settings > Connections

Сканування

Код	HTTP	Значення	Виправлення
SCAN_NOT_FOUND	404	ID сканування не існує або належить іншому тенанту	Перевірте ID сканування
SCAN_ALREADY_RUNNING	409	Для цього тенанта вже виконується сканування	Дочекайтеся завершення поточного сканування
SCAN_PLAN_LIMIT_REACHED	429	Квоту на сканування вичерпано	Зачекайте до наступного розрахункового періоду або зверніться до підтримки
SERVICE_UNAVAILABLE	503	Платформа в режимі обслуговування	Перевірте статус і спробуйте знову після завершення обслуговування

Підключення

Код	HTTP	Значення	Виправлення
CONNECTION_NOT_FOUND	404	ID підключення не існує	Перевірте ID підключення
CANNOT_REMOVE_LAST_CONNECTION	409	Неможливо видалити єдине наявне підключення	Додайте інше підключення перед видаленням цього

Учасники команди

Код	HTTP	Значення	Виправлення
MEMBER_LIMIT_REACHED	429	Досягнуто ліміту учасників	Зверніться до підтримки, щоб додати більше учасників
MEMBER_ALREADY_EXISTS	409	Ця електронна пошта вже має активне або очікуване запрошення	Перевірте поточний список учасників

Заплановані сканування

Код	HTTP	Значення	Виправлення
SCAN_PLAN_LIMIT_REACHED	429	Досягнуто ліміту користувацьких розкладів	Видаліть наявний розклад або зверніться до підтримки

Валідація

Код	HTTP	Значення
VALIDATION_ERROR	400	Тіло запиту або параметр запиту недійсні. Поле details перелічує конкретні недійсні поля.

Помилки сервера

Код	HTTP	Значення	Виправлення
INTERNAL_ERROR	500	Неочікувана помилка сервера	Повторіть запит. Якщо помилка не зникає, зверніться до підтримки, вказавши ID запиту із заголовків відповіді.

Обмеження частоти запитів

Коли ви перевищуєте обмеження частоти запитів API, API повертає:

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Too many requests. Retry after 60 seconds."
  }
}

HTTP-статус: 429 Too Many Requests Заголовок: Retry-After: 60

Поточні обмеження частоти: 120 запитів за хвилину на кожен ключ API.