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	Loesning
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 udloebet	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	Bekraeft, at du bruger en konto med den paakraevede rolle

Autorisation

Kode	HTTP	Betydning	Loesning
TENANT_ACCESS_DENIED	403	Forsoeg paa at faa adgang til en anden tenants data	Dette boer aldrig ske ved normal brug - kontakt support, hvis du ser dette
AUTH_INSUFFICIENT_SCOPE	403	Utilstraekkelige tilladelser til denne handling	Bekraeft, at du bruger en konto med den paakraevede rolle

Tenant

Kode	HTTP	Betydning	Loesning
TENANT_NOT_FOUND	404	Ingen tenantkonto eksisterer for denne bruger	Opret en konto paa app.aether365.io
TENANT_NOT_CONNECTED	400	Microsoft 365 admin-samtykke er ikke gennemfoert	Forbind en tenant via Indstillinger > Forbindelser

Scanninger

Kode	HTTP	Betydning	Loesning
SCAN_NOT_FOUND	404	Scannings-ID eksisterer ikke eller tilhoerer en anden tenant	Kontrollér scannings-ID'et
SCAN_ALREADY_RUNNING	409	En scanning er allerede i gang for denne tenant	Vent paa, at den aktuelle scanning afsluttes
SCAN_PLAN_LIMIT_REACHED	429	Scanningskvote opbrugt	Vent til naeste faktureringsperiode eller kontakt support
SERVICE_UNAVAILABLE	503	Platformen er i vedligeholdelsestilstand	Kontrollér status og proev igen, naar vedligeholdelsen er afsluttet

Forbindelser

Kode	HTTP	Betydning	Loesning
CONNECTION_NOT_FOUND	404	Forbindelses-ID eksisterer ikke	Kontrollér forbindelses-ID'et
CANNOT_REMOVE_LAST_CONNECTION	409	Kan ikke fjerne den eneste tilbagevaerende forbindelse	Tilfoej en anden forbindelse, foer du fjerner denne

Teammedlemmer

Kode	HTTP	Betydning	Loesning
MEMBER_LIMIT_REACHED	429	Medlemsgraense naaet	Kontakt support for at tilfoeje 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	Loesning
SCAN_PLAN_LIMIT_REACHED	429	Graense for brugerdefinerede tidsplaner naaet	Slet en eksisterende tidsplan eller kontakt support

Validering

Kode	HTTP	Betydning
VALIDATION_ERROR	400	Foresprgselsindhold eller foresprgselsparameter er ugyldig. details-feltet opremser de specifikke ugyldige felter.

Serverfejl

Kode	HTTP	Betydning	Loesning
INTERNAL_ERROR	500	Uventet serverfejl	Proev forespørgslen igen. Hvis fejlen fortsaetter, kontakt support med forespørgselens ID fra svarheaderne.

Frekvensbegransninger

Naar du overskrider API-frekvensgraensen, 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 frekvensgraenser: 120 forespørgsler pr. minut pr. API-noegle.