Limiti di Velocità

I limiti di velocità proteggono l'API da abusi e garantiscono un utilizzo equo per tutti i clienti. I limiti variano in base al piano.

Limiti per Piano

Ogni risposta API include informazioni sui limiti di velocità negli header:

Intestazione	Descrizione
`X-RateLimit-Limit`	Richieste massime al minuto per il tuo piano
`X-RateLimit-Remaining`	Richieste rimanenti nella finestra corrente
`X-RateLimit-Reset`	Timestamp Unix di quando il limite viene reimpostato

Quando superi il limite di velocità, l'API restituisce una risposta 429 Too Many Requests. Per gestirlo in modo appropriato:

429 Troppe Richieste

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Retry after 30 seconds."
  }
}

Piano

Richieste/min

Crediti/mese

Gratuito

1.000

Pay As You Go

In base all'acquisto

Progetto

7.000

Bootstrap

28.000

Startup

85.000

Crescita

200.000

Intestazione

Descrizione

X-RateLimit-Limit

Richieste massime al minuto per il tuo piano

X-RateLimit-Remaining

Richieste rimanenti nella finestra corrente

X-RateLimit-Reset

Timestamp Unix di quando il limite viene reimpostato

Gestione degli Errori 429

Quando superi il limite di velocità, l'API restituisce una risposta 429 Too Many Requests. Per gestirlo in modo appropriato:

Controlla l'header X-RateLimit-Reset per sapere quando puoi riprovare

Implementa un backoff esponenziale nella logica di ripetizione

Accoda le richieste per rimanere entro il limite al minuto

Considera l'aggiornamento del piano se raggiungi costantemente i limiti

429 Troppe Richieste

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Retry after 30 seconds."
  }
}