Vai al contenuto principale
L’API Enrow applica limiti di frequenza per garantire un utilizzo equo e mantenere la qualità del servizio. Il limite è lo stesso per tutti gli endpoint e tutti i piani, viene applicato per chiave API ed è misurato in richieste al secondo (RPS). Questa pagina illustra i limiti predefiniti, cosa accade quando li superi e come rimanere entro la quota quando aumenti il volume.

​
Quali sono i limiti di frequenza predefiniti?

Ogni endpoint POST consente 10 richieste al secondo per chiave API. Il limite è identico per tutti gli endpoint e tutti i piani:
EndpointLimite di frequenza
POST /email/find/single10 req/s
POST /email/find/bulk10 req/s
POST /email/verify/single10 req/s
POST /email/verify/bulk10 req/s
POST /phone/single10 req/s
POST /phone/bulk10 req/s
Gli endpoint GET non sono soggetti a limiti di frequenza, quindi il recupero dei risultati — ad esempio il risultato di una singola email o i risultati bulk — non viene conteggiato sulla tua quota.
I limiti di frequenza sono per chiave API e misurati in richieste al secondo (RPS). Ogni chiave API ha la propria quota indipendente.

​
Cosa accade quando supero il limite di frequenza?

Quando superi il limite di frequenza, l’API restituisce una risposta 429 Too Many Requests: 
{
  "message": "Too Many Requests"
}
Il modo consigliato per gestire un 429 è implementare un backoff esponenziale — attendere un ritardo progressivamente più lungo prima di ogni nuovo tentativo, in modo che la chiave API abbia il tempo di rientrare sotto il limite: 
async function requestWithRetry(url, options, maxRetries = 3) {
  for (let attempt = 0; attempt < maxRetries; attempt++) {
    const response = await fetch(url, options);

    if (response.status === 429) {
      const delay = Math.pow(2, attempt) * 1000;
      await new Promise(resolve => setTimeout(resolve, delay));
      continue;
    }

    return response;
  }

  throw new Error('Max retries exceeded');
}
Per l’elenco completo dei codici di risposta e su come gestirli, consulta Codici di stato e Gestione degli errori.

​
Come posso evitare di raggiungere il limite di frequenza?

Il modo più efficace per rimanere entro la quota è inviare richieste meno numerose e più grandi e ricevere i risultati tramite webhook anziché tramite polling.
Invece di effettuare 100 richieste singole, effettua 1 richiesta bulk (fino a 5.000 elementi per le email, 3.000 per i telefoni). Una singola richiesta POST bulk conta come 1 richiesta rispetto al tuo limite di frequenza.
// ❌ 100 requests = 10 seconds at 10 RPS
for (const contact of contacts) {
  await findEmail(contact);
}

// ✅ 1 request
await findEmailsBulk(contacts);
Consulta Trova email multiple e Verifica email multiple per iniziare.
Il polling dell’endpoint GET spreca la quota del tuo limite di frequenza. Usa i webhook per ricevere i risultati automaticamente non appena una ricerca o una verifica viene completata.
Conserva i risultati per evitare chiamate API ridondanti per lo stesso contatto, il che consente anche di risparmiare crediti.

​
Posso ottenere limiti di frequenza più alti?

Sì. Enrow può aumentare i tuoi RPS caso per caso. Contattaci all’indirizzo api@enrow.io indicando il tuo caso d’uso e il volume previsto.

​
FAQ

No. Il limite di 10 req/s si applica in modo indipendente a ciascun endpoint POST e la quota viene monitorata per chiave API anziché per account.
No. Gli endpoint GET non sono soggetti a limiti di frequenza, quindi il polling dei risultati non consuma la tua quota RPS. Detto questo, i webhook restano comunque preferibili al polling frequente.
Sì. Una singola richiesta POST bulk conta come 1 richiesta rispetto al tuo limite di frequenza, anche se può contenere fino a 5.000 elementi per le email o 3.000 per i telefoni.
Una risposta 429 Too Many Requests con il corpo { "message": "Too Many Requests" }. Riprova con backoff esponenziale. Consulta Gestione degli errori per i dettagli.

​
Prossimi passi

Trova email multiple

Esegui fino a 5.000 ricerche di email in un’unica richiesta per risparmiare quota del limite di frequenza.

Webhook

Ricevi i risultati automaticamente invece di effettuare il polling degli endpoint GET.

Gestione degli errori

Gestisci con eleganza il 429 e le altre risposte nella tua integrazione.

Crediti e fatturazione

Scopri come vengono consumati i crediti per ciascun endpoint.