Fejlkoder

Alle API-fejl returnerer en konsistent JSON-struktur:

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

Autentificering

Kode	HTTP	Betydning	Løsning
AUTH_MISSING_TOKEN	401	Ingen Authorization-header i forespørgslen	Inkludér Authorization: Bearer <token> i hver forespørgsel
AUTH_INVALID_TOKEN	401	JWT kunne ikke verificeres	Kontrollér, at tokenet ikke er misdannet eller afkortet
AUTH_EXPIRED_TOKEN	401	JWT er udløbet	Hent et nyt token ved at logge ind igen eller opdatere sessionen
AUTH_INSUFFICIENT_SCOPE	403	Den autentificerede konto har ikke tilladelse til denne handling	Bekræft, at du bruger en konto med den påkrævede rolle

Autorisation

Kode	HTTP	Betydning	Løsning
TENANT_ACCESS_DENIED	403	Forsøg på at få adgang til en anden tenants data	Dette bør aldrig ske ved normal brug - kontakt support, hvis du ser dette
AUTH_INSUFFICIENT_SCOPE	403	Utilstrækkelige tilladelser til denne handling	Bekræft, at du bruger en konto med den påkrævede rolle

Tenant

Kode	HTTP	Betydning	Løsning
TENANT_NOT_FOUND	404	Ingen tenantkonto eksisterer for denne bruger	Opret en konto på app.aether365.io
TENANT_NOT_CONNECTED	400	Microsoft 365 admin-samtykke er ikke gennemført	Forbind en tenant via Indstillinger > Forbindelser

Scanninger

Kode	HTTP	Betydning	Løsning
SCAN_NOT_FOUND	404	Scannings-ID eksisterer ikke eller tilhører en anden tenant	Kontrollér scannings-ID'et
SCAN_ALREADY_RUNNING	409	En scanning er allerede i gang for denne tenant	Vent på, at den aktuelle scanning afsluttes
SCAN_PLAN_LIMIT_REACHED	429	Scanningskvote opbrugt	Vent til næste faktureringsperiode eller kontakt support
SERVICE_UNAVAILABLE	503	Platformen er i vedligeholdelsestilstand	Kontrollér status og prøv igen, når vedligeholdelsen er afsluttet

Forbindelser

Kode	HTTP	Betydning	Løsning
CONNECTION_NOT_FOUND	404	Forbindelses-ID eksisterer ikke	Kontrollér forbindelses-ID'et
CANNOT_REMOVE_LAST_CONNECTION	409	Kan ikke fjerne den eneste tilbageværende forbindelse	Tilføj en anden forbindelse, før du fjerner denne

Teammedlemmer

Kode	HTTP	Betydning	Løsning
MEMBER_LIMIT_REACHED	429	Medlemsgrænse nået	Kontakt support for at tilføje flere medlemmer
MEMBER_ALREADY_EXISTS	409	E-mail har allerede en aktiv eller afventende invitation	Kontrollér den aktuelle medlemsliste

Planlagte scanninger

Kode	HTTP	Betydning	Løsning
SCAN_PLAN_LIMIT_REACHED	429	Grænse for brugerdefinerede tidsplaner nået	Slet en eksisterende tidsplan eller kontakt support

Validering

Kode	HTTP	Betydning
VALIDATION_ERROR	400	Forespørgselsindhold eller forespørgselsparameter er ugyldig. details-feltet opremser de specifikke ugyldige felter.

Serverfejl

Kode	HTTP	Betydning	Løsning
INTERNAL_ERROR	500	Uventet serverfejl	Prøv forespørgslen igen. Hvis fejlen fortsætter, kontakt support med forespørgslens ID fra svarheaderne.

Frekvensbegrænsninger

Når du overskrider API-frekvensgrænsen, returnerer API'et:

{
  "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

Aktuelle frekvensgrænser: 120 forespørgsler pr. minut pr. API-nøgle.