> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enrow.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Limites de débit

> Enrow API rate limits per API key, the 429 response, and how to handle throttling with backoff and bulk endpoints

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 :

| Endpoint                    | Limite de débit |
| --------------------------- | --------------- |
| `POST /email/find/single`   | 10 req/s        |
| `POST /email/find/bulk`     | 10 req/s        |
| `POST /email/verify/single` | 10 req/s        |
| `POST /email/verify/bulk`   | 10 req/s        |
| `POST /phone/single`        | 10 req/s        |
| `POST /phone/bulk`          | 10 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](/fr/api-reference/email-finder/get-single-result) ou les [résultats en masse](/fr/api-reference/email-finder/get-bulk-results) — n'est donc pas décompté de votre quota.

<Note>
  Les limites de débit s'appliquent **par clé API** et se mesurent en **requêtes par seconde** (RPS). Chaque [clé API](/fr/authentication) dispose de son propre quota indépendant.
</Note>

## 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` :

```json theme={null}
{
  "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 :

```javascript theme={null}
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](/fr/status-codes) et [Gestion des erreurs](/fr/error-handling).

## 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.

<AccordionGroup>
  <Accordion title="Utiliser les endpoints en masse">
    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.

    ```javascript theme={null}
    // ❌ 100 requests = 10 seconds at 10 RPS
    for (const contact of contacts) {
      await findEmail(contact);
    }

    // ✅ 1 request
    await findEmailsBulk(contacts);
    ```

    Consultez [Rechercher des emails](/fr/api-reference/email-finder/find-bulk) et [Vérifier des emails](/fr/api-reference/email-verifier/verify-bulk) pour démarrer.
  </Accordion>

  <Accordion title="Utiliser les webhooks plutôt que le polling">
    Interroger l'endpoint GET en continu gaspille votre quota de débit. Utilisez les [webhooks](/fr/how-webhooks-work) pour recevoir les résultats automatiquement dès qu'une recherche ou une vérification se termine.
  </Accordion>

  <Accordion title="Mettre les résultats en cache">
    Stockez les résultats pour éviter les appels API redondants pour un même contact, ce qui économise également des [crédits](/fr/credits-billing).
  </Accordion>
</AccordionGroup>

## 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](mailto:api@enrow.io) en précisant votre cas d'usage et le volume attendu.

## FAQ

<AccordionGroup>
  <Accordion title="Les limites de débit sont-elles partagées entre les endpoints ?">
    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.
  </Accordion>

  <Accordion title="Les requêtes GET sont-elles décomptées de la limite de débit ?">
    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.
  </Accordion>

  <Accordion title="Une requête en masse compte-t-elle comme une seule requête ?">
    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.
  </Accordion>

  <Accordion title="Quel code de statut signale une erreur de limite de débit ?">
    Une réponse `429 Too Many Requests` avec le corps `{ "message": "Too Many Requests" }`. Réessayez avec un backoff exponentiel. Consultez [Gestion des erreurs](/fr/error-handling) pour plus de détails.
  </Accordion>
</AccordionGroup>

## Prochaines étapes

<CardGroup cols={2}>
  <Card title="Rechercher des emails en masse" icon="layer-group" href="/fr/api-reference/email-finder/find-bulk">
    Lancez jusqu'à 5 000 recherches d'emails en une seule requête pour économiser votre quota de débit.
  </Card>

  <Card title="Webhooks" icon="bell" href="/fr/how-webhooks-work">
    Recevez les résultats automatiquement au lieu d'interroger les endpoints GET.
  </Card>

  <Card title="Gestion des erreurs" icon="triangle-exclamation" href="/fr/error-handling">
    Gérez le 429 et les autres réponses correctement dans votre intégration.
  </Card>

  <Card title="Crédits et facturation" icon="coins" href="/fr/credits-billing">
    Découvrez comment les crédits sont consommés pour chaque endpoint.
  </Card>
</CardGroup>