Erori

Toate erorile au formatul RFC 7807 — Problem Details, cu Content-Type: application/problem+json:

{
  "type": "about:blank",
  "title": "Not found",
  "status": 404,
  "detail": "CAEN \"6201\" is a Rev.2 code replaced in Rev.3 (since 2025-01-01); use: 6210"
}

(Exemplu real: căutarea unui cod CAEN Rev.2 scos din uz răspunde 404 și îți spune succesorii Rev.3.)

Catalog de statusuri

Status	Când apare	Ce faci
400 Bad Request	parametri invalizi (validare schema)	corectează inputul după detail
401 Unauthorized	cheie lipsă/invalidă pe un endpoint care cere autentificare	verifică headerul Authorization
402 Payment Required	credite epuizate pe luna curentă	așteaptă resetarea sau fă upgrade
403 Forbidden	planul tău nu include operația	vezi x-entitlement în OpenAPI
404 Not Found	resursa nu există	—
429 Too Many Requests	rate limit depășit	reia după Retry-After (secunde)
5xx	eroare internă sau upstream	reîncearcă cu backoff; detaliile interne nu sunt expuse

Recomandări pentru retry

Tratează 429 și 5xx ca retriabile (exponential backoff, respectă Retry-After). 4xx-urile de validare nu sunt retriabile — același input va eșua identic.