Foutcodes

Onderhouden door: Aether365 Team Doelgroep: Ontwikkelaars en IT-beheerders Scope: Volledige referentie van Aether365 API-foutcodes

Alle API-fouten retourneren een consistente JSON-structuur:

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

Authenticatie

Code	HTTP	Betekenis	Oplossing
AUTH_MISSING_TOKEN	401	Geen Authorization-header in het verzoek	Voeg Authorization: Bearer <token> toe aan elk verzoek
AUTH_INVALID_TOKEN	401	JWT kon niet worden geverifieerd	Controleer of het token niet onjuist gevormd of afgekapt is
AUTH_EXPIRED_TOKEN	401	JWT is verlopen	Verkrijg een nieuw token door opnieuw aan te melden of de sessie te vernieuwen
AUTH_INSUFFICIENT_SCOPE	403	Het geauthenticeerde account heeft geen machtiging voor deze actie	Controleer of je een account met de vereiste rol gebruikt

Autorisatie

Code	HTTP	Betekenis	Oplossing
TENANT_ACCESS_DENIED	403	Verzoek probeerde toegang te krijgen tot gegevens van een andere tenant	Dit zou bij normaal gebruik nooit mogen voorkomen - neem contact op met support als je dit ziet
AUTH_INSUFFICIENT_SCOPE	403	Onvoldoende machtigingen voor deze actie	Controleer of je een account met de vereiste rol gebruikt

Tenant

Code	HTTP	Betekenis	Oplossing
TENANT_NOT_FOUND	404	Er bestaat geen tenantaccount voor deze gebruiker	Maak een account aan op app.aether365.io
TENANT_NOT_CONNECTED	400	Microsoft 365 admin consent is niet voltooid	Verbind een tenant via Instellingen > Koppelingen

Scans

Code	HTTP	Betekenis	Oplossing
SCAN_NOT_FOUND	404	Scan-ID bestaat niet of behoort tot een andere tenant	Controleer de scan-ID
SCAN_ALREADY_RUNNING	409	Er loopt al een scan voor deze tenant	Wacht tot de huidige scan is voltooid
SCAN_PLAN_LIMIT_REACHED	429	Scanlimiet bereikt	Wacht tot de volgende factureringsperiode of neem contact op met support
SERVICE_UNAVAILABLE	503	Platform is in onderhoudsmodus	Controleer de status en probeer het opnieuw na het onderhoud

Koppelingen

Code	HTTP	Betekenis	Oplossing
CONNECTION_NOT_FOUND	404	Koppeling-ID bestaat niet	Controleer de koppeling-ID
CANNOT_REMOVE_LAST_CONNECTION	409	Kan de enige overgebleven koppeling niet verwijderen	Voeg eerst een andere koppeling toe voordat je deze verwijdert

Teamleden

Code	HTTP	Betekenis	Oplossing
MEMBER_LIMIT_REACHED	429	Ledenmaximum bereikt	Neem contact op met support om meer leden toe te voegen
MEMBER_ALREADY_EXISTS	409	E-mailadres heeft al een actieve of openstaande uitnodiging	Controleer de huidige ledenlijst

Geplande scans

Code	HTTP	Betekenis	Oplossing
SCAN_PLAN_LIMIT_REACHED	429	Limiet voor aangepaste schema's bereikt	Verwijder een bestaand schema of neem contact op met support

Validatie

Code	HTTP	Betekenis
VALIDATION_ERROR	400	Verzoekbody of queryparameter is ongeldig. Het details-veld vermeldt de specifieke ongeldige velden.

Serverfouten

Code	HTTP	Betekenis	Oplossing
INTERNAL_ERROR	500	Onverwachte serverfout	Probeer het verzoek opnieuw. Als de fout aanhoudt, neem dan contact op met support met de verzoek-ID uit de response-headers.

Snelheidslimieten

Wanneer je de API-snelheidslimiet overschrijdt, retourneert de API:

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

Huidige snelheidslimieten: 120 verzoeken per minuut per API key.