# Errori e limiti di frequenza
Source: https://nordvec.com/it/docs/guides/errors-and-rate-limits#la-busta-di-errore

## La busta di errore [#la-busta-di-errore]

Ogni risposta non-2xx è un oggetto JSON:

```json
{
  "defined": false,
  "code": "TOO_MANY_REQUESTS",
  "message": "Too many requests",
  "data": { "reason": "rate_limit.exceeded", "retryAfterMs": 12000 }
}
```

* `code` è l'errore a livello HTTP, ad esempio `UNAUTHORIZED`, `FORBIDDEN`,
  `NOT_FOUND`, `BAD_REQUEST` o `TOO_MANY_REQUESTS`.
* `data.reason`, quando presente, è un motivo più preciso leggibile dalla macchina come
  `auth.key_not_found` o `rate_limit.exceeded`. Fai branching su questo piuttosto che su
  `message`, che è per le persone e può cambiare.
* `defined` è `true` quando l'operazione elenca quell'errore nella
  [riferimento API](/docs/api), e `false` per errori che qualsiasi richiesta può incontrare
  (autenticazione, limiti di frequenza, una rotta sconosciuta).
* Un fallimento di validazione risponde `BAD_REQUEST` con i problemi in
  `data.formErrors` e `data.fieldErrors`.

Ogni risposta include anche un `X-Request-ID`. Citalo quando contatti
l'assistenza, così possiamo trovare quella richiesta esatta.