Felkoder

Underhalls av: Aether365 Team Malgrupp: Utvecklare och IT-administratorer Omfattning: Fullstandig referens over 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	Losning
AUTH_MISSING_TOKEN	401	Inget Authorization-huvud i forfragan	Inkludera Authorization: Bearer <token> i varje forfragan
AUTH_INVALID_TOKEN	401	JWT kunde inte verifieras	Kontrollera att token inte ar felformaterad eller avkortad
AUTH_EXPIRED_TOKEN	401	JWT har lopt ut	Skaffa en ny token genom att logga in igen eller uppdatera sessionen
AUTH_INSUFFICIENT_SCOPE	403	Det autentiserade kontot har inte behorighet for denna atgard	Verifiera att du anvander ett konto med ratt roll

Auktorisering

Kod	HTTP	Betydelse	Losning
TENANT_ACCESS_DENIED	403	Forfragan forskte fa atkomst till en annan tenants data	Detta bor aldrig intrffa vid normal anvandning - kontakta support om du ser detta
AUTH_INSUFFICIENT_SCOPE	403	Otillrackliga behorigheter for denna atgard	Verifiera att du anvander ett konto med ratt roll

Tenant

Kod	HTTP	Betydelse	Losning
TENANT_NOT_FOUND	404	Inget tenantkonto finns for denna anvandare	Skapa ett konto pa app.aether365.io
TENANT_NOT_CONNECTED	400	Microsoft 365 administratorssamtycke har inte slutforts	Anslut en tenant via Installningar > Anslutningar

Skanningar

Kod	HTTP	Betydelse	Losning
SCAN_NOT_FOUND	404	Skannings-ID finns inte eller tillhor en annan tenant	Kontrollera skannings-ID:t
SCAN_ALREADY_RUNNING	409	En skanning pagar redan for denna tenant	Vanta tills aktuell skanning slutfors
SCAN_PLAN_LIMIT_REACHED	429	Skanningskvoten ar forbrukad	Vanta till nasta faktureringsperiod eller kontakta support
SERVICE_UNAVAILABLE	503	Plattformen ar i underhallslage	Kontrollera status och forsk igen nar underhallet ar avslutat

Anslutningar

Kod	HTTP	Betydelse	Losning
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	Lagg till en annan anslutning innan du tar bort denna

Teammedlemmar

Kod	HTTP	Betydelse	Losning
MEMBER_LIMIT_REACHED	429	Medlemsgransen ar nadd	Kontakta support for att lagga till fler medlemmar
MEMBER_ALREADY_EXISTS	409	E-postadressen har redan en aktiv eller vantande inbjudan	Kontrollera den aktuella medlemslistan

Schemalagda skanningar

Kod	HTTP	Betydelse	Losning
SCAN_PLAN_LIMIT_REACHED	429	Gransen for anpassade scheman ar nadd	Radera ett befintligt schema eller kontakta support

Validering

Kod	HTTP	Betydelse
VALIDATION_ERROR	400	Forfragans brodotext eller fragesparameter ar ogiltig. Faltet details listar de specifika ogiltiga falten.

Serverfel

Kod	HTTP	Betydelse	Losning
INTERNAL_ERROR	500	Ovantat serverfel	Forsk med forfragan igen. Om felet kvarstar, kontakta support med forfragan-ID:t fran svarsrubrikerna.

Hastighetsbegransningar

Nar du overskrider API:ets hastighetsbegransning 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 hastighetsbegransningar: 120 forfragan per minut per API-nyckel.