Fehlercodes

Betreut von: Aether365 Team Zielgruppe: Entwickler und IT-Administratoren Umfang: Vollständige Referenz aller Aether365 API-Fehlercodes

Alle API-Fehler geben eine einheitliche JSON-Struktur zurück:

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

Authentifizierung

Code	HTTP	Bedeutung	Lösung
AUTH_MISSING_TOKEN	401	Kein Authorization-Header in der Anfrage	Fügen Sie Authorization: Bearer <token> in jede Anfrage ein
AUTH_INVALID_TOKEN	401	JWT konnte nicht verifiziert werden	Prüfen Sie, ob das Token nicht fehlerhaft oder abgeschnitten ist
AUTH_EXPIRED_TOKEN	401	JWT ist abgelaufen	Holen Sie sich ein neues Token durch erneute Anmeldung oder Sitzungsaktualisierung
AUTH_INSUFFICIENT_SCOPE	403	Das authentifizierte Konto hat keine Berechtigung für diese Aktion	Stellen Sie sicher, dass Sie ein Konto mit der erforderlichen Rolle verwenden

Autorisierung

Code	HTTP	Bedeutung	Lösung
TENANT_ACCESS_DENIED	403	Zugriff auf Daten eines anderen Tenants versucht	Dies sollte bei normaler Nutzung nie auftreten - kontaktieren Sie den Support
AUTH_INSUFFICIENT_SCOPE	403	Unzureichende Berechtigungen für diese Aktion	Stellen Sie sicher, dass Sie ein Konto mit der erforderlichen Rolle verwenden

Tenant

Code	HTTP	Bedeutung	Lösung
TENANT_NOT_FOUND	404	Kein Tenant-Konto für diesen Benutzer vorhanden	Erstellen Sie ein Konto unter app.aether365.io
TENANT_NOT_CONNECTED	400	Microsoft 365 Admin-Zustimmung wurde nicht abgeschlossen	Verbinden Sie einen Tenant über Einstellungen > Verbindungen

Scans

Code	HTTP	Bedeutung	Lösung
SCAN_NOT_FOUND	404	Scan-ID existiert nicht oder gehört zu einem anderen Tenant	Überprüfen Sie die Scan-ID
SCAN_ALREADY_RUNNING	409	Für diesen Tenant läuft bereits ein Scan	Warten Sie, bis der aktuelle Scan abgeschlossen ist
SCAN_PLAN_LIMIT_REACHED	429	Scan-Kontingent erschöpft	Warten Sie bis zum nächsten Abrechnungszeitraum oder kontaktieren Sie den Support
SERVICE_UNAVAILABLE	503	Plattform befindet sich im Wartungsmodus	Prüfen Sie den Status und versuchen Sie es nach der Wartung erneut

Verbindungen

Code	HTTP	Bedeutung	Lösung
CONNECTION_NOT_FOUND	404	Verbindungs-ID existiert nicht	Überprüfen Sie die Verbindungs-ID
CANNOT_REMOVE_LAST_CONNECTION	409	Die einzige verbleibende Verbindung kann nicht entfernt werden	Fügen Sie eine weitere Verbindung hinzu, bevor Sie diese entfernen

Teammitglieder

Code	HTTP	Bedeutung	Lösung
MEMBER_LIMIT_REACHED	429	Mitgliederlimit erreicht	Kontaktieren Sie den Support, um weitere Mitglieder hinzuzufügen
MEMBER_ALREADY_EXISTS	409	E-Mail hat bereits eine aktive Mitgliedschaft oder offene Einladung	Überprüfen Sie die aktuelle Mitgliederliste

Geplante Scans

Code	HTTP	Bedeutung	Lösung
SCAN_PLAN_LIMIT_REACHED	429	Limit für benutzerdefinierte Zeitpläne erreicht	Löschen Sie einen bestehenden Zeitplan oder kontaktieren Sie den Support

Validierung

Code	HTTP	Bedeutung
VALIDATION_ERROR	400	Anfragekörper oder Abfrageparameter ist ungültig. Das Feld details listet die spezifisch ungültigen Felder auf.

Serverfehler

Code	HTTP	Bedeutung	Lösung
INTERNAL_ERROR	500	Unerwarteter Serverfehler	Wiederholen Sie die Anfrage. Wenn der Fehler bestehen bleibt, kontaktieren Sie den Support mit der Request-ID aus den Antwort-Headern.

Ratenlimits

Wenn Sie das API-Ratenlimit überschreiten, gibt die API zurück:

{
  "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 Ratenlimits: 120 Anfragen pro Minute pro API Key.