# Erori
Toate erorile au formatul [RFC 7807 — Problem Details](https://www.rfc-editor.org/rfc/rfc7807), cu `Content-Type: application/problem+json`:

```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.