Coduri de eroare

Toate erorile API returnează o structură JSON consistentă:

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

Autentificare

Cod	HTTP	Semnificație	Soluție
AUTH_MISSING_TOKEN	401	Niciun header Authorization în cerere	Includeți Authorization: Bearer <token> în fiecare cerere
AUTH_INVALID_TOKEN	401	JWT-ul nu a putut fi verificat	Verificați că token-ul nu este malformat sau trunchiat
AUTH_EXPIRED_TOKEN	401	JWT-ul a expirat	Obțineți un token nou autentificându-vă din nou sau reîmprospătând sesiunea
AUTH_INSUFFICIENT_SCOPE	403	Contul autentificat nu are permisiuni pentru această acțiune	Verificați că folosiți un cont cu rolul necesar

Autorizare

Cod	HTTP	Semnificație	Soluție
TENANT_ACCESS_DENIED	403	Cererea a încercat să acceseze datele altui tenant	Aceasta nu ar trebui să apară în utilizare normală - contactați suportul dacă o vedeți
AUTH_INSUFFICIENT_SCOPE	403	Permisiuni insuficiente pentru această acțiune	Verificați că folosiți un cont cu rolul necesar

Tenant

Cod	HTTP	Semnificație	Soluție
TENANT_NOT_FOUND	404	Nu există niciun cont tenant pentru acest utilizator	Creați un cont la app.aether365.io
TENANT_NOT_CONNECTED	400	Admin consent-ul Microsoft 365 nu a fost finalizat	Conectați un tenant prin Settings > Connections

Scanări

Cod	HTTP	Semnificație	Soluție
SCAN_NOT_FOUND	404	ID-ul scanării nu există sau aparține altui tenant	Verificați ID-ul scanării
SCAN_ALREADY_RUNNING	409	O scanare este deja în curs pentru acest tenant	Așteptați finalizarea scanării curente
SCAN_PLAN_LIMIT_REACHED	429	Cota de scanare epuizată	Așteptați următoarea perioadă de facturare sau contactați suportul
SERVICE_UNAVAILABLE	503	Platforma este în modul de mentenanță	Verificați statusul și încercați din nou când mentenanța se încheie

Conexiuni

Cod	HTTP	Semnificație	Soluție
CONNECTION_NOT_FOUND	404	ID-ul conexiunii nu există	Verificați ID-ul conexiunii
CANNOT_REMOVE_LAST_CONNECTION	409	Nu se poate elimina singura conexiune rămasă	Adăugați o altă conexiune înainte de a o elimina pe aceasta

Membri echipă

Cod	HTTP	Semnificație	Soluție
MEMBER_LIMIT_REACHED	429	Limita de membri atinsă	Contactați suportul pentru a adăuga mai mulți membri
MEMBER_ALREADY_EXISTS	409	Email-ul are deja o invitație activă sau în așteptare	Verificați lista curentă de membri

Scanări programate

Cod	HTTP	Semnificație	Soluție
SCAN_PLAN_LIMIT_REACHED	429	Limita de programări personalizate atinsă	Ștergeți o programare existentă sau contactați suportul

Validare

Cod	HTTP	Semnificație
VALIDATION_ERROR	400	Corpul cererii sau parametrul de query este invalid. Câmpul details listează câmpurile invalide specifice.

Erori de server

Cod	HTTP	Semnificație	Soluție
INTERNAL_ERROR	500	Eroare de server neașteptată	Reincercați cererea. Dacă eroarea persistă, contactați suportul cu ID-ul cererii din headerele răspunsului.

Limite de rată

Când depășiți limita de rată a API-ului, API-ul returnează:

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

Status HTTP: 429 Too Many Requests Header: Retry-After: 60

Limitele de rată curente: 120 cereri pe minut per cheie API.