> ## Documentation Index
> Fetch the complete documentation index at: https://docs.syrto.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Rate limit

> Come l'API Syrto limita le richieste e gli header che riportano il tuo budget.

Le richieste sono limitate al minuto. Il limite si applica a ciascun endpoint in modo indipendente ed è definito dal tuo piano.

## Header di rate limit

Ogni chiamata a un endpoint restituisce il tuo budget attuale:

| Header                  | Descrizione                                                   |
| ----------------------- | ------------------------------------------------------------- |
| `X-RateLimit-Limit`     | Il numero massimo di richieste al minuto per questo endpoint. |
| `X-RateLimit-Remaining` | Richieste rimaste nella finestra corrente.                    |
| `X-RateLimit-Reset`     | Secondi al completo ripristino del budget.                    |

Il limite si ricarica in modo continuo anziché azzerarsi a un confine fisso, quindi `X-RateLimit-Remaining` si riprende gradualmente tra una chiamata e l'altra.

## Quando superi il limite

Una richiesta oltre il limite restituisce [`429 rate_limited`](/it/api/errors) con un header `Retry-After` che indica i secondi da attendere:

```json theme={null}
{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded.",
    "requestId": "req_018f9c2e7b7a7c3e9a1b2c3d4e5f6a7b"
  }
}
```

Il rate limiting è applicato prima di qualsiasi controllo di fatturazione, quindi una richiesta limitata non viene mai addebitata. Attendi l'intervallo `Retry-After`, poi riprova.

<Tip>
  Leggi `X-RateLimit-Remaining` dalle tue risposte e rallenta man mano che si avvicina a zero, anziché aspettare un `429`.
</Tip>