Chybové kódy

Spravuje: tým Aether365 Určeno pro: vývojáře a IT správce Rozsah: úplný přehled chybových kódů API Aether365

Všechny chyby API vracejí konzistentní strukturu JSON:

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

Ověřování

Kód	HTTP	Význam	Náprava
AUTH_MISSING_TOKEN	401	V požadavku chybí hlavička Authorization	Do každého požadavku přidejte Authorization: Bearer <token>
AUTH_INVALID_TOKEN	401	JWT nebylo možné ověřit	Zkontrolujte, zda token není poškozený nebo zkrácený
AUTH_EXPIRED_TOKEN	401	Platnost JWT vypršela	Získejte nový token opětovným přihlášením nebo obnovením relace
AUTH_INSUFFICIENT_SCOPE	403	Ověřený účet nemá oprávnění k této akci	Ověřte, že používáte účet s požadovanou rolí

Autorizace

Kód	HTTP	Význam	Náprava
TENANT_ACCESS_DENIED	403	Požadavek se pokusil o přístup k datům jiného tenantu	Při běžném používání by k tomu nikdy nemělo dojít - pokud to vidíte, kontaktujte podporu
AUTH_INSUFFICIENT_SCOPE	403	Nedostatečná oprávnění k této akci	Ověřte, že používáte účet s požadovanou rolí

Tenant

Kód	HTTP	Význam	Náprava
TENANT_NOT_FOUND	404	Pro tohoto uživatele neexistuje žádný účet tenantu	Vytvořte účet na app.aether365.io
TENANT_NOT_CONNECTED	400	Souhlas správce Microsoft 365 nebyl dokončen	Připojte tenant přes Nastavení > Připojení

Skeny

Kód	HTTP	Význam	Náprava
SCAN_NOT_FOUND	404	ID skenu neexistuje nebo patří jinému tenantu	Zkontrolujte ID skenu
SCAN_ALREADY_RUNNING	409	Pro tento tenant již probíhá sken	Počkejte na dokončení aktuálního skenu
SCAN_PLAN_LIMIT_REACHED	429	Vyčerpaná kvóta skenů	Počkejte na další zúčtovací období nebo kontaktujte podporu
SERVICE_UNAVAILABLE	503	Platforma je v režimu údržby	Zkontrolujte stav a zkuste to znovu po skončení údržby

Připojení

Kód	HTTP	Význam	Náprava
CONNECTION_NOT_FOUND	404	ID připojení neexistuje	Zkontrolujte ID připojení
CANNOT_REMOVE_LAST_CONNECTION	409	Nelze odebrat jediné zbývající připojení	Před odebráním tohoto připojení přidejte další

Členové týmu

Kód	HTTP	Význam	Náprava
MEMBER_LIMIT_REACHED	429	Dosažen limit počtu členů	Pro přidání dalších členů kontaktujte podporu
MEMBER_ALREADY_EXISTS	409	E-mail již má aktivní nebo čekající pozvánku	Zkontrolujte aktuální seznam členů

Plánované skeny

Kód	HTTP	Význam	Náprava
SCAN_PLAN_LIMIT_REACHED	429	Dosažen limit vlastních plánů	Odstraňte stávající plán nebo kontaktujte podporu

Validace

Kód	HTTP	Význam
VALIDATION_ERROR	400	Tělo požadavku nebo parametr dotazu je neplatný. Pole details uvádí konkrétní neplatná pole.

Chyby serveru

Kód	HTTP	Význam	Náprava
INTERNAL_ERROR	500	Neočekávaná chyba serveru	Opakujte požadavek. Pokud chyba přetrvává, kontaktujte podporu a uveďte ID požadavku z hlaviček odpovědi.

Limity počtu požadavků

Když překročíte limit počtu požadavků API, API vrátí:

{
  "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ální limity počtu požadavků: 120 požadavků za minutu na jeden API klíč.