Rate limit

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 con un header Retry-After che indica i secondi da attendere:

{
  "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.

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

Per iniziare

Endpoint di esempio

Riferimento interattivo

Riferimento

Header di rate limit

Quando superi il limite

​Header di rate limit

​Quando superi il limite

Header di rate limit

Quando superi il limite