Passer au contenu principal
L’API Enrow applique des limites de débit afin de garantir une utilisation équitable et de maintenir la qualité du service. La limite est identique pour tous les endpoints et tous les plans, elle s’applique par clé API et elle se mesure en requêtes par seconde (RPS). Cette page explique les limites par défaut, ce qui se passe lorsque vous les dépassez et comment rester dans votre quota lors de la montée en charge.

​
Quelles sont les limites de débit par défaut ?

Chaque endpoint POST autorise 10 requêtes par seconde par clé API. La limite est identique pour tous les endpoints et tous les plans :
EndpointLimite de débit
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
Les endpoints GET ne sont pas soumis à des limites de débit : récupérer des résultats — par exemple le résultat d’un email unique ou les résultats en masse — n’est donc pas décompté de votre quota.
Les limites de débit s’appliquent par clé API et se mesurent en requêtes par seconde (RPS). Chaque clé API dispose de son propre quota indépendant.

​
Que se passe-t-il lorsque je dépasse la limite de débit ?

Lorsque vous dépassez la limite de débit, l’API renvoie une réponse 429 Too Many Requests : 
{
  "message": "Too Many Requests"
}
La méthode recommandée pour gérer un 429 consiste à mettre en place un backoff exponentiel — attendre un délai de plus en plus long avant chaque nouvelle tentative, afin de laisser à la clé API le temps de repasser sous la 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');
}
Pour la liste complète des codes de réponse et la façon de les gérer, consultez Codes de statut et Gestion des erreurs.

​
Comment éviter d’atteindre la limite de débit ?

Le moyen le plus efficace de rester dans votre quota est d’envoyer moins de requêtes mais plus volumineuses, et de recevoir les résultats via des webhooks plutôt que par polling.
Au lieu d’effectuer 100 requêtes unitaires, faites 1 requête en masse (jusqu’à 5 000 éléments pour l’email, 3 000 pour le téléphone). Un seul POST en masse compte comme 1 requête au regard de votre limite de débit.
// ❌ 100 requests = 10 seconds at 10 RPS
for (const contact of contacts) {
  await findEmail(contact);
}

// ✅ 1 request
await findEmailsBulk(contacts);
Consultez Rechercher des emails et Vérifier des emails pour démarrer.
Interroger l’endpoint GET en continu gaspille votre quota de débit. Utilisez les webhooks pour recevoir les résultats automatiquement dès qu’une recherche ou une vérification se termine.
Stockez les résultats pour éviter les appels API redondants pour un même contact, ce qui économise également des crédits.

​
Puis-je obtenir des limites de débit plus élevées ?

Oui. Enrow peut augmenter votre RPS au cas par cas. Contactez-nous à l’adresse api@enrow.io en précisant votre cas d’usage et le volume attendu.

​
FAQ

Non. La limite de 10 req/s s’applique indépendamment à chaque endpoint POST, et le quota est suivi par clé API plutôt que par compte.
Non. Les endpoints GET ne sont pas soumis à des limites de débit : interroger les résultats ne consomme donc pas votre quota de RPS. Cela dit, les webhooks restent préférables à un polling fréquent.
Oui. Un seul POST en masse compte comme 1 requête au regard de votre limite de débit, même s’il peut contenir jusqu’à 5 000 éléments pour l’email ou 3 000 pour le téléphone.
Une réponse 429 Too Many Requests avec le corps { "message": "Too Many Requests" }. Réessayez avec un backoff exponentiel. Consultez Gestion des erreurs pour plus de détails.

​
Prochaines étapes

Rechercher des emails en masse

Lancez jusqu’à 5 000 recherches d’emails en une seule requête pour économiser votre quota de débit.

Webhooks

Recevez les résultats automatiquement au lieu d’interroger les endpoints GET.

Gestion des erreurs

Gérez le 429 et les autres réponses correctement dans votre intégration.

Crédits et facturation

Découvrez comment les crédits sont consommés pour chaque endpoint.