Chybové kódy

Spravuje: tím Aether365 Publikum: vývojári a IT správcovia Rozsah: úplná referencia chybových kódov API Aether365

Všetky chyby API vracajú konzistentnú štruktúru JSON:

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

Autentifikácia

Kód	HTTP	Význam	Riešenie
AUTH_MISSING_TOKEN	401	V požiadavke chýba hlavička Authorization	Do každej požiadavky zahrňte Authorization: Bearer <token>
AUTH_INVALID_TOKEN	401	JWT sa nepodarilo overiť	Skontrolujte, či token nie je poškodený alebo skrátený
AUTH_EXPIRED_TOKEN	401	Platnosť JWT vypršala	Získajte nový token opätovným prihlásením alebo obnovením relácie
AUTH_INSUFFICIENT_SCOPE	403	Autentifikovaný účet nemá oprávnenie na túto akciu	Overte, že používate účet s požadovanou rolou

Autorizácia

Kód	HTTP	Význam	Riešenie
TENANT_ACCESS_DENIED	403	Požiadavka sa pokúsila pristúpiť k dátam iného nájomníka	Pri bežnom používaní by k tomu nikdy nemalo dôjsť - ak to vidíte, kontaktujte podporu
AUTH_INSUFFICIENT_SCOPE	403	Nedostatočné oprávnenia na túto akciu	Overte, že používate účet s požadovanou rolou

Nájomník

Kód	HTTP	Význam	Riešenie
TENANT_NOT_FOUND	404	Pre tohto používateľa neexistuje účet nájomníka	Vytvorte účet na app.aether365.io
TENANT_NOT_CONNECTED	400	Súhlas správcu Microsoft 365 nebol dokončený	Pripojte nájomníka cez Settings > Connections

Skeny

Kód	HTTP	Význam	Riešenie
SCAN_NOT_FOUND	404	ID skenu neexistuje alebo patrí inému nájomníkovi	Skontrolujte ID skenu
SCAN_ALREADY_RUNNING	409	Pre tohto nájomníka už prebieha sken	Počkajte na dokončenie aktuálneho skenu
SCAN_PLAN_LIMIT_REACHED	429	Kvóta skenov je vyčerpaná	Počkajte na ďalšie zúčtovacie obdobie alebo kontaktujte podporu
SERVICE_UNAVAILABLE	503	Platforma je v režime údržby	Skontrolujte stav a skúste to znova po skončení údržby

Pripojenia

Kód	HTTP	Význam	Riešenie
CONNECTION_NOT_FOUND	404	ID pripojenia neexistuje	Skontrolujte ID pripojenia
CANNOT_REMOVE_LAST_CONNECTION	409	Nemožno odstrániť jediné zostávajúce pripojenie	Pred odstránením tohto pripojenia pridajte ďalšie

Členovia tímu

Kód	HTTP	Význam	Riešenie
MEMBER_LIMIT_REACHED	429	Dosiahnutý limit členov	Kontaktujte podporu pre pridanie ďalších členov
MEMBER_ALREADY_EXISTS	409	E-mail už má aktívnu alebo čakajúcu pozvánku	Skontrolujte aktuálny zoznam členov

Plánované skeny

Kód	HTTP	Význam	Riešenie
SCAN_PLAN_LIMIT_REACHED	429	Dosiahnutý limit vlastných plánov	Odstráňte existujúci plán alebo kontaktujte podporu

Validácia

Kód	HTTP	Význam
VALIDATION_ERROR	400	Telo požiadavky alebo parameter dotazu je neplatný. Pole details uvádza konkrétne neplatné polia.

Chyby servera

Kód	HTTP	Význam	Riešenie
INTERNAL_ERROR	500	Neočakávaná chyba servera	Zopakujte požiadavku. Ak chyba pretrváva, kontaktujte podporu a uveďte ID požiadavky z hlavičiek odpovede.

Limity rýchlosti (Rate Limits)

Keď prekročíte limit rýchlosti API, API vráti:

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

Stav HTTP: 429 Too Many Requests Hlavička: Retry-After: 60

Aktuálne limity rýchlosti: 120 požiadaviek za minútu na jeden API kľúč.