Kode napak

Vzdržuje: ekipa Aether365 Občinstvo: razvijalci in skrbniki IT Obseg: popoln pregled kod napak API-ja Aether365

Vse napake API-ja vrnejo dosledno strukturo JSON:

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

Preverjanje pristnosti

Koda	HTTP	Pomen	Rešitev
AUTH_MISSING_TOKEN	401	V zahtevi ni glave Authorization	V vsako zahtevo vključite Authorization: Bearer <token>
AUTH_INVALID_TOKEN	401	Žetona JWT ni bilo mogoče preveriti	Preverite, da žeton ni okvarjen ali odrezan
AUTH_EXPIRED_TOKEN	401	Žeton JWT je potekel	Pridobite nov žeton s ponovno prijavo ali osvežitvijo seje
AUTH_INSUFFICIENT_SCOPE	403	Preverjeni račun nima dovoljenja za to dejanje	Preverite, ali uporabljate račun z zahtevano vlogo

Avtorizacija

Koda	HTTP	Pomen	Rešitev
TENANT_ACCESS_DENIED	403	Zahteva je poskušala dostopati do podatkov drugega najemnika	Pri običajni uporabi se to nikoli ne bi smelo zgoditi - če to opazite, se obrnite na podporo
AUTH_INSUFFICIENT_SCOPE	403	Nezadostna dovoljenja za to dejanje	Preverite, ali uporabljate račun z zahtevano vlogo

Najemnik

Koda	HTTP	Pomen	Rešitev
TENANT_NOT_FOUND	404	Za tega uporabnika ne obstaja noben račun najemnika	Ustvarite račun na app.aether365.io
TENANT_NOT_CONNECTED	400	Soglasje skrbnika Microsoft 365 ni bilo dokončano	Povežite najemnik prek Nastavitve > Povezave

Preverbe

Koda	HTTP	Pomen	Rešitev
SCAN_NOT_FOUND	404	ID preverbe ne obstaja ali pripada drugemu najemniku	Preverite ID preverbe
SCAN_ALREADY_RUNNING	409	Za tega najemnika že poteka preverba	Počakajte, da se trenutna preverba zaključi
SCAN_PLAN_LIMIT_REACHED	429	Kvota preverb je izčrpana	Počakajte do naslednjega obračunskega obdobja ali se obrnite na podporo
SERVICE_UNAVAILABLE	503	Platforma je v načinu vzdrževanja	Preverite stanje in poskusite znova, ko se vzdrževanje konča

Povezave

Koda	HTTP	Pomen	Rešitev
CONNECTION_NOT_FOUND	404	ID povezave ne obstaja	Preverite ID povezave
CANNOT_REMOVE_LAST_CONNECTION	409	Edine preostale povezave ni mogoče odstraniti	Pred odstranitvijo te povezave dodajte drugo

Člani ekipe

Koda	HTTP	Pomen	Rešitev
MEMBER_LIMIT_REACHED	429	Dosežena je omejitev števila članov	Za dodajanje več članov se obrnite na podporo
MEMBER_ALREADY_EXISTS	409	E-pošta že ima aktivno ali nerešeno povabilo	Preverite trenutni seznam članov

Načrtovane preverbe

Koda	HTTP	Pomen	Rešitev
SCAN_PLAN_LIMIT_REACHED	429	Dosežena je omejitev urnikov po meri	Izbrišite obstoječ urnik ali se obrnite na podporo

Validacija

Koda	HTTP	Pomen
VALIDATION_ERROR	400	Telo zahteve ali parameter poizvedbe je neveljaven. Polje details navaja posamezna neveljavna polja.

Napake strežnika

Koda	HTTP	Pomen	Rešitev
INTERNAL_ERROR	500	Nepričakovana napaka strežnika	Ponovite zahtevo. Če napaka ne izgine, se obrnite na podporo in navedite ID zahteve iz glav odgovora.

Omejitve hitrosti

Ko presežete omejitev hitrosti API-ja, API vrne:

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

Stanje HTTP: 429 Too Many Requests Glava: Retry-After: 60

Trenutne omejitve hitrosti: 120 zahtev na minuto na ključ API.