Kody błędów

Autor: Zespół Aether365 Odbiorcy: Deweloperzy i administratorzy IT Zakres: Kompletna lista kodów błędów API Aether365

Wszystkie błędy API zwracają spójną strukturę JSON:

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

Uwierzytelnianie

Kod	HTTP	Znaczenie	Rozwiązanie
AUTH_MISSING_TOKEN	401	Brak nagłówka Authorization w żądaniu	Dołącz Authorization: Bearer <token> do każdego żądania
AUTH_INVALID_TOKEN	401	Nie udało się zweryfikować tokenu JWT	Sprawdź, czy token nie jest zniekształcony lub obcięty
AUTH_EXPIRED_TOKEN	401	Token JWT wygasł	Uzyskaj nowy token, logując się ponownie lub odświeżając sesję
AUTH_INSUFFICIENT_SCOPE	403	Uwierzytelnione konto nie ma uprawnień do tego działania	Sprawdź, czy używasz konta z wymaganą rolą

Autoryzacja

Kod	HTTP	Znaczenie	Rozwiązanie
TENANT_ACCESS_DENIED	403	Żądanie próbowało uzyskać dostęp do danych innego tenanta	Nie powinno to wystąpić w normalnym użytkowaniu - skontaktuj się z pomocą techniczną
AUTH_INSUFFICIENT_SCOPE	403	Niewystarczające uprawnienia dla tego działania	Sprawdź, czy używasz konta z wymaganą rolą

Tenant

Kod	HTTP	Znaczenie	Rozwiązanie
TENANT_NOT_FOUND	404	Brak konta tenanta dla tego użytkownika	Utwórz konto na app.aether365.io
TENANT_NOT_CONNECTED	400	Zgoda administratora Microsoft 365 nie została ukończona	Połącz tenanta przez Ustawienia > Połączenia

Skany

Kod	HTTP	Znaczenie	Rozwiązanie
SCAN_NOT_FOUND	404	Identyfikator skanu nie istnieje lub należy do innego tenanta	Sprawdź identyfikator skanu
SCAN_ALREADY_RUNNING	409	Skan jest już w toku dla tego tenanta	Poczekaj na zakończenie bieżącego skanu
SCAN_PLAN_LIMIT_REACHED	429	Wyczerpano limit skanów	Poczekaj do następnego okresu rozliczeniowego lub skontaktuj się z pomocą techniczną
SERVICE_UNAVAILABLE	503	Platforma jest w trybie konserwacji	Sprawdź status i spróbuj ponownie po zakończeniu konserwacji

Połączenia

Kod	HTTP	Znaczenie	Rozwiązanie
CONNECTION_NOT_FOUND	404	Identyfikator połączenia nie istnieje	Sprawdź identyfikator połączenia
CANNOT_REMOVE_LAST_CONNECTION	409	Nie można usunąć jedynego pozostałego połączenia	Dodaj kolejne połączenie przed usunięciem tego

Członkowie zespołu

Kod	HTTP	Znaczenie	Rozwiązanie
MEMBER_LIMIT_REACHED	429	Osiągnięto limit członków	Skontaktuj się z pomocą techniczną, aby dodać więcej członków
MEMBER_ALREADY_EXISTS	409	Adres e-mail ma już aktywne lub oczekujące zaproszenie	Sprawdź bieżącą listę członków

Zaplanowane skany

Kod	HTTP	Znaczenie	Rozwiązanie
SCAN_PLAN_LIMIT_REACHED	429	Osiągnięto limit własnych harmonogramów	Usuń istniejący harmonogram lub skontaktuj się z pomocą techniczną

Walidacja

Kod	HTTP	Znaczenie
VALIDATION_ERROR	400	Treść żądania lub parametr zapytania jest nieprawidłowy. Pole details zawiera listę konkretnych nieprawidłowych pól.

Błędy serwera

Kod	HTTP	Znaczenie	Rozwiązanie
INTERNAL_ERROR	500	Nieoczekiwany błąd serwera	Ponów żądanie. Jeśli błąd się powtarza, skontaktuj się z pomocą techniczną, podając identyfikator żądania z nagłówków odpowiedzi.

Limity częstotliwości

Po przekroczeniu limitu częstotliwości API zwraca:

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

Status HTTP: 429 Too Many Requests Nagłówek: Retry-After: 60

Aktualne limity częstotliwości: 120 żądań na minutę na klucz API.