Кодове за грешка

Всички 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	Заявката е опитала достъп до данни на друг tenant	Това не трябва да се случва при нормална употреба - свържете се с поддръжката
AUTH_INSUFFICIENT_SCOPE	403	Недостатъчни права за това действие	Проверете дали използвате акаунт с необходимата роля

Tenant

Код	HTTP	Значение	Решение
TENANT_NOT_FOUND	404	Няма акаунт на tenant за този потребител	Създайте акаунт на app.aether365.io
TENANT_NOT_CONNECTED	400	Администраторското съгласие на Microsoft 365 не е завършено	Свържете tenant чрез Settings > Connections

Сканирания

Код	HTTP	Значение	Решение
SCAN_NOT_FOUND	404	Идентификаторът на сканирането не съществува или принадлежи на друг tenant	Проверете идентификатора на сканирането
SCAN_ALREADY_RUNNING	409	Сканиране вече е в ход за този tenant	Изчакайте текущото сканиране да завърши
SCAN_PLAN_LIMIT_REACHED	429	Квотата за сканирания е изчерпана	Изчакайте следващия период на таксуване или се свържете с поддръжката
SERVICE_UNAVAILABLE	503	Платформата е в режим на поддръжка	Проверете статуса и опитайте отново, когато поддръжката приключи

Връзки

Код	HTTP	Значение	Решение
CONNECTION_NOT_FOUND	404	Идентификаторът на връзката не съществува	Проверете идентификатора на връзката
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	Неочаквана сървърна грешка	Опитайте заявката отново. Ако грешката продължава, свържете се с поддръжката с идентификатора на заявката от заглавията на отговора.

Лимити на заявките

Когато превишите лимита на 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 ключ.