Hibakódok

Minden API hiba egységes JSON struktúrát ad vissza:

{
  "success": false,
  "error": {
    "code": "SNAKE_CASE_ERROR_CODE",
    "message": "Ember által olvasható leírás",
    "details": {}
  }
}

Hitelesítés

Kód	HTTP	Jelentés	Megoldás
AUTH_MISSING_TOKEN	401	Nincs Authorization fejléc a kérésben	Adj hozzá Authorization: Bearer <token> fejlécet minden kéréshez
AUTH_INVALID_TOKEN	401	A JWT nem ellenőrizhető	Ellenőrizd, hogy a token nem hibás vagy csonkított-e
AUTH_EXPIRED_TOKEN	401	A JWT lejárt	Szerezz új tokent újbóli bejelentkezéssel vagy a munkamenet frissítésével
AUTH_INSUFFICIENT_SCOPE	403	A hitelesített fiók nem rendelkezik engedéllyel ehhez a művelethez	Ellenőrizd, hogy a megfelelő szerepkörrel rendelkező fiókot használod-e

Jogosultság

Kód	HTTP	Jelentés	Megoldás
TENANT_ACCESS_DENIED	403	A kérés egy másik bérlő adataihoz próbált hozzáférni	Ez normál használat során soha nem fordulhat elő - lépj kapcsolatba a támogatással
AUTH_INSUFFICIENT_SCOPE	403	Elégtelen engedélyek ehhez a művelethez	Ellenőrizd, hogy a megfelelő szerepkörrel rendelkező fiókot használod-e

Bérlő

Kód	HTTP	Jelentés	Megoldás
TENANT_NOT_FOUND	404	Nem létezik bérlő fiók ehhez a felhasználóhoz	Hozz létre fiókot az app.aether365.io oldalon
TENANT_NOT_CONNECTED	400	A Microsoft 365 admin consent nincs befejezve	Csatlakoztass egy bérlőt a Beállítások > Csatlakozások menüben

Vizsgálatok

Kód	HTTP	Jelentés	Megoldás
SCAN_NOT_FOUND	404	A vizsgálat-azonosító nem létezik vagy másik bérlőhöz tartozik	Ellenőrizd a vizsgálat-azonosítót
SCAN_ALREADY_RUNNING	409	Egy vizsgálat már folyamatban van ehhez a bérlőhöz	Várd meg az aktuális vizsgálat befejezését
SCAN_PLAN_LIMIT_REACHED	429	A vizsgálati kvóta kimerült	Várd meg a következő számlázási időszakot vagy lépj kapcsolatba a támogatással
SERVICE_UNAVAILABLE	503	A platform karbantartási módban van	Ellenőrizd az állapotot és próbáld újra a karbantartás végén

Csatlakozások

Kód	HTTP	Jelentés	Megoldás
CONNECTION_NOT_FOUND	404	A csatlakozás-azonosító nem létezik	Ellenőrizd a csatlakozás-azonosítót
CANNOT_REMOVE_LAST_CONNECTION	409	Az egyetlen megmaradt csatlakozás nem távolítható el	Adj hozzá egy másik csatlakozást az eltávolítás előtt

Csapattagok

Kód	HTTP	Jelentés	Megoldás
MEMBER_LIMIT_REACHED	429	A taglétszám korlát elérve	Lépj kapcsolatba a támogatással több tag hozzáadásához
MEMBER_ALREADY_EXISTS	409	Az e-mail cím már rendelkezik aktív vagy függő meghívóval	Ellenőrizd az aktuális taglistát

Ütemezett vizsgálatok

Kód	HTTP	Jelentés	Megoldás
SCAN_PLAN_LIMIT_REACHED	429	Az egyedi ütemezés korlát elérve	Törölj egy meglévő ütemezést vagy lépj kapcsolatba a támogatással

Validáció

Kód	HTTP	Jelentés
VALIDATION_ERROR	400	A kéréstörzs vagy lekérdezési paraméter érvénytelen. A details mező felsorolja az érvénytelen mezőket.

Szerverhiba

Kód	HTTP	Jelentés	Megoldás
INTERNAL_ERROR	500	Váratlan szerverhiba	Próbáld meg újra a kérést. Ha a hiba fennmarad, lépj kapcsolatba a támogatással a válasz fejlécben lévő kérés-azonosítóval.

Sebességkorlátozás

Ha túlléped az API sebességkorlátot, az API a következőt adja vissza:

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

HTTP státusz: 429 Too Many Requests Fejléc: Retry-After: 60

Aktuális sebességkorlátok: percenként 120 kérés API kulcsonként.