Virhekoodit

Ylläpitäjä: Aether365-tiimi Kohderyhmä: Kehittäjät ja IT-ylläpitäjät Laajuus: Täydellinen viite Aether365 API:n virhekoodeihin

Kaikki API-virheet palauttavat yhdenmukaisen JSON-rakenteen:

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

Todennus

Koodi	HTTP	Merkitys	Ratkaisu
AUTH_MISSING_TOKEN	401	Authorization-otsikko puuttuu pyynnöstä	Sisällytä Authorization: Bearer <token> jokaiseen pyyntöön
AUTH_INVALID_TOKEN	401	JWT:tä ei voitu todentaa	Tarkista ettei token ole väärinmuodostettu tai katkaistu
AUTH_EXPIRED_TOKEN	401	JWT on vanhentunut	Hanki uusi token kirjautumalla uudelleen tai päivittämällä istunto
AUTH_INSUFFICIENT_SCOPE	403	Todennetulla tilillä ei ole oikeutta tähän toimintoon	Varmista että käytät tiliä, jolla on vaadittu rooli

Valtuutus

Koodi	HTTP	Merkitys	Ratkaisu
TENANT_ACCESS_DENIED	403	Pyyntö yritti käyttää toisen vuokralaisen tietoja	Tämän ei pitäisi tapahtua normaalikäytössä - ota yhteyttä tukeen jos näet tämän
AUTH_INSUFFICIENT_SCOPE	403	Riittämättömät oikeudet tälle toiminnolle	Varmista että käytät tiliä, jolla on vaadittu rooli

Vuokralainen

Koodi	HTTP	Merkitys	Ratkaisu
TENANT_NOT_FOUND	404	Käyttäjälle ei ole vuokralaistiliä	Luo tili osoitteessa app.aether365.io
TENANT_NOT_CONNECTED	400	Microsoft 365 -hallintasuostumusta ei ole suoritettu	Yhdistä vuokralainen kohdasta Asetukset > Yhteydet

Skannaukset

Koodi	HTTP	Merkitys	Ratkaisu
SCAN_NOT_FOUND	404	Skannaus-ID:tä ei ole tai se kuuluu toiselle vuokralaiselle	Tarkista skannaus-ID
SCAN_ALREADY_RUNNING	409	Skannaus on jo käynnissä tälle vuokralaiselle	Odota nykyisen skannauksen valmistumista
SCAN_PLAN_LIMIT_REACHED	429	Skannauskiintiö käytetty	Odota seuraavaan laskutuskauteen tai ota yhteyttä tukeen
SERVICE_UNAVAILABLE	503	Alusta on huoltotilassa	Tarkista tila ja yritä uudelleen huollon päätyttyä

Yhteydet

Koodi	HTTP	Merkitys	Ratkaisu
CONNECTION_NOT_FOUND	404	Yhteystunnistetta ei ole olemassa	Tarkista yhteystunniste
CANNOT_REMOVE_LAST_CONNECTION	409	Viimeistä jäljellä olevaa yhteyttä ei voi poistaa	Lisää toinen yhteys ennen tämän poistamista

Tiimijäsenet

Koodi	HTTP	Merkitys	Ratkaisu
MEMBER_LIMIT_REACHED	429	Jäsenraja saavutettu	Ota yhteyttä tukeen lisäjäseniä varten
MEMBER_ALREADY_EXISTS	409	Sähköpostilla on jo aktiivinen tai odottava kutsu	Tarkista nykyinen jäsenluettelo

Aikataulutetut skannaukset

Koodi	HTTP	Merkitys	Ratkaisu
SCAN_PLAN_LIMIT_REACHED	429	Mukautettujen aikataulujen raja saavutettu	Poista olemassa oleva aikataulu tai ota yhteyttä tukeen

Validointi

Koodi	HTTP	Merkitys
VALIDATION_ERROR	400	Pyynnön runko tai kyselyparametri on virheellinen. details-kenttä listaa tarkemmat virheelliset kentät.

Palvelinvirheet

Koodi	HTTP	Merkitys	Ratkaisu
INTERNAL_ERROR	500	Odottamaton palvelinvirhe	Yritä pyyntöä uudelleen. Jos virhe jatkuu, ota yhteyttä tukeen vastausotsikkojen pyyntötunnuksen kanssa.

Nopeusrajoitukset

Kun ylität API:n nopeusrajan, API palauttaa:

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

HTTP-tila: 429 Too Many Requests Otsikko: Retry-After: 60

Nykyiset nopeusrajoitukset: 120 pyyntöä minuutissa API-avainta kohden.