Rate Limiting

L'API ha limiti di richieste per garantire stabilità e equità d'uso.

Limiti per Piano

Piano	Richieste/minuto	Richieste/giorno
Free	100	5.000
Pro	500	50.000
Enterprise	2.000	Illimitate

Header di Risposta

Ogni risposta include header informativi:

Header	Descrizione
X-RateLimit-Limit	Limite massimo
X-RateLimit-Remaining	Richieste rimanenti
X-RateLimit-Reset	Timestamp reset (Unix)

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1705320000

Superamento Limite

Se superi il limite, ricevi:

HTTP/1.1 429 Too Many Requests
Retry-After: 60

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Limite richieste superato. Riprova tra 60 secondi."
  }
}

Best Practices

Gestire i Limiti

async function makeRequest(url) {
  const response = await fetch(url, { headers });
  
  if (response.status === 429) {
    const retryAfter = response.headers.get('Retry-After');
    await sleep(retryAfter * 1000);
    return makeRequest(url); // Riprova
  }
  
  return response.json();
}

Ottimizzare le Richieste

• ✅ Usa la paginazione per liste grandi
• ✅ Richiedi solo i campi necessari
• ✅ Usa i webhooks invece di polling
• ✅ Implementa caching lato client

---

TIP

Se hai bisogno di limiti maggiori, contatta il supporto per discutere un piano Enterprise.