Felkoder

Underhålls av: Aether365 Team Målgrupp: Utvecklare och IT-administratörer Omfattning: Fullständig referens över Aether365 API-felkoder

Alla API-fel returnerar en konsekvent JSON-struktur:

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

Autentisering

Kod	HTTP	Betydelse	Lösning
AUTH_MISSING_TOKEN	401	Inget Authorization-huvud i förfrågan	Inkludera Authorization: Bearer <token> i varje förfrågan
AUTH_INVALID_TOKEN	401	JWT kunde inte verifieras	Kontrollera att token inte är felformaterad eller avkortad
AUTH_EXPIRED_TOKEN	401	JWT har löpt ut	Skaffa en ny token genom att logga in igen eller uppdatera sessionen
AUTH_INSUFFICIENT_SCOPE	403	Det autentiserade kontot har inte behörighet för denna åtgärd	Verifiera att du använder ett konto med rätt roll

Auktorisering

Kod	HTTP	Betydelse	Lösning
TENANT_ACCESS_DENIED	403	Förfrågan försökte få åtkomst till en annan tenants data	Detta bör aldrig inträffa vid normal användning - kontakta support om du ser detta
AUTH_INSUFFICIENT_SCOPE	403	Otillräckliga behörigheter för denna åtgärd	Verifiera att du använder ett konto med rätt roll

Tenant

Kod	HTTP	Betydelse	Lösning
TENANT_NOT_FOUND	404	Inget tenantkonto finns för denna användare	Skapa ett konto på app.aether365.io
TENANT_NOT_CONNECTED	400	Microsoft 365 administratörssamtycke har inte slutförts	Anslut en tenant via Inställningar > Anslutningar

Skanningar

Kod	HTTP	Betydelse	Lösning
SCAN_NOT_FOUND	404	Skannings-ID finns inte eller tillhör en annan tenant	Kontrollera skannings-ID:t
SCAN_ALREADY_RUNNING	409	En skanning pågår redan för denna tenant	Vänta tills aktuell skanning slutförs
SCAN_PLAN_LIMIT_REACHED	429	Skanningskvoten är förbrukad	Vänta till nästa faktureringsperiod eller kontakta support
SERVICE_UNAVAILABLE	503	Plattformen är i underhållsläge	Kontrollera status och försök igen när underhållet är avslutat

Anslutningar

Kod	HTTP	Betydelse	Lösning
CONNECTION_NOT_FOUND	404	Anslutnings-ID finns inte	Kontrollera anslutnings-ID:t
CANNOT_REMOVE_LAST_CONNECTION	409	Kan inte ta bort den enda kvarvarande anslutningen	Lägg till en annan anslutning innan du tar bort denna

Teammedlemmar

Kod	HTTP	Betydelse	Lösning
MEMBER_LIMIT_REACHED	429	Medlemsgränsen är nådd	Kontakta support för att lägga till fler medlemmar
MEMBER_ALREADY_EXISTS	409	E-postadressen har redan en aktiv eller väntande inbjudan	Kontrollera den aktuella medlemslistan

Schemalagda skanningar

Kod	HTTP	Betydelse	Lösning
SCAN_PLAN_LIMIT_REACHED	429	Gränsen för anpassade scheman är nådd	Radera ett befintligt schema eller kontakta support

Validering

Kod	HTTP	Betydelse
VALIDATION_ERROR	400	Förfrågans brödotext eller frågesparameter är ogiltig. Fältet details listar de specifika ogiltiga fälten.

Serverfel

Kod	HTTP	Betydelse	Lösning
INTERNAL_ERROR	500	Oväntat serverfel	Försök med förfrågan igen. Om felet kvarstår, kontakta support med förfrågan-ID:t från svarsrubrikerna.

Hastighetsbegränsningar

När du överskrider API:ets hastighetsbegränsning returnerar API:t:

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

HTTP-status: 429 Too Many Requests Huvud: Retry-After: 60

Aktuella hastighetsbegränsningar: 120 förfrågan per minut per API-nyckel.