Rate Limits

Le API Replicer applicano rate limit per chiave utilizzando un algoritmo a finestra scorrevole. I limiti variano in base al piano di abbonamento.

Limiti per piano

Piano	Richieste al minuto
Pay As You Go	60
Hobbyist	60
Personal	120
Professional	300

Header di risposta

Ogni risposta API include gli header del rate limit:

Header	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 quando la finestra si resetta

Esempio:

HTTP/1.1 200 OK
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 85
X-RateLimit-Reset: 1712324460

Superamento del limite

Quando superi il rate limit, l'API restituisce 429 Too Many Requests:

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Try again in 45 seconds"
  },
  "requestId": "req-abc123"
}

La risposta include un header Retry-After con il numero di secondi da attendere:

HTTP/1.1 429 Too Many Requests
Retry-After: 45
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1712324460

Best practice

• Controlla gli header: Monitora X-RateLimit-Remaining per evitare di raggiungere il limite
• Implementa il backoff: Quando ricevi un 429, attendi i secondi indicati in Retry-After prima di riprovare
• Operazioni batch: Usa gli endpoint di lista con paginazione invece di ricerche individuali
• Cache delle risposte: Metti in cache i dati in sola lettura quando possibile per ridurre le chiamate API
• Aggiorna il piano: Se hai bisogno costantemente di più throughput, passa a un piano superiore