Feilkoder

Vedlikeholdt av: Aether365 Team Målgruppe: Utviklere og IT-administratorer Omfang: Fullstendig referanse for Aether365 API-feilkoder

Alle API-feil returnerer en konsistent JSON-struktur:

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

Autentisering

Kode	HTTP	Betydning	Løsning
AUTH_MISSING_TOKEN	401	Ingen Authorization-header i forespørselen	Inkluder Authorization: Bearer <token> i alle forespørsler
AUTH_INVALID_TOKEN	401	JWT kunne ikke verifiseres	Sjekk at tokenet ikke er feilformatert eller avkortet
AUTH_EXPIRED_TOKEN	401	JWT har utløpt	Hent et nytt token ved å logge inn på nytt eller oppdatere økten
AUTH_INSUFFICIENT_SCOPE	403	Den autentiserte kontoen har ikke tillatelse til denne handlingen	Kontroller at du bruker en konto med den påkrevde rollen

Autorisasjon

Kode	HTTP	Betydning	Løsning
TENANT_ACCESS_DENIED	403	Forespørselen forsøkte å få tilgang til en annen leietakers data	Dette skal aldri forekomme ved normal bruk - kontakt kundestøtte hvis du ser dette
AUTH_INSUFFICIENT_SCOPE	403	Utilstrekkelige tillatelser for denne handlingen	Kontroller at du bruker en konto med den påkrevde rollen

Leietaker

Kode	HTTP	Betydning	Løsning
TENANT_NOT_FOUND	404	Ingen leietakerkonto eksisterer for denne brukeren	Opprett en konto på app.aether365.io
TENANT_NOT_CONNECTED	400	Microsoft 365 admin-samtykke er ikke fullført	Koble til en leietaker via Innstillinger > Tilkoblinger

Skanninger

Kode	HTTP	Betydning	Løsning
SCAN_NOT_FOUND	404	Skanne-ID eksisterer ikke eller tilhører en annen leietaker	Sjekk skanne-IDen
SCAN_ALREADY_RUNNING	409	En skanning pågår allerede for denne leietakeren	Vent til den pågående skanningen fullføres
SCAN_PLAN_LIMIT_REACHED	429	Skannekvoten er brukt opp	Vent til neste faktureringsperiode eller kontakt kundestøtte
SERVICE_UNAVAILABLE	503	Plattformen er i vedlikeholdsmodus	Sjekk status og prøv igjen når vedlikeholdet er over

Tilkoblinger

Kode	HTTP	Betydning	Løsning
CONNECTION_NOT_FOUND	404	Tilkoblings-ID eksisterer ikke	Sjekk tilkoblings-IDen
CANNOT_REMOVE_LAST_CONNECTION	409	Kan ikke fjerne den eneste gjenværende tilkoblingen	Legg til en annen tilkobling før du fjerner denne

Teammedlemmer

Kode	HTTP	Betydning	Løsning
MEMBER_LIMIT_REACHED	429	Medlemsgrensen er nådd	Kontakt kundestøtte for å legge til flere medlemmer
MEMBER_ALREADY_EXISTS	409	E-posten har allerede en aktiv eller ventende invitasjon	Sjekk gjeldende medlemsliste

Planlagte skanninger

Kode	HTTP	Betydning	Løsning
SCAN_PLAN_LIMIT_REACHED	429	Grensen for egendefinerte tidsplaner er nådd	Slett en eksisterende tidsplan eller kontakt kundestøtte

Validering

Kode	HTTP	Betydning
VALIDATION_ERROR	400	Forespørselens brødtekst eller spørreparameter er ugyldig. details-feltet lister de ugyldige feltene.

Serverfeil

Kode	HTTP	Betydning	Løsning
INTERNAL_ERROR	500	Uventet serverfeil	Prøv forespørselen på nytt. Hvis feilen vedvarer, kontakt kundestøtte med forespørsel-IDen fra responshodene.

Ratebegrensninger

Når du overstiger API-ratebegrensningen, returnerer APIet:

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

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

Gjeldende ratebegrensninger: 120 forespørsler per minutt per API-nøkkel.