Limites de débit

Les limites de débit protègent l'API contre les abus et garantissent un usage équitable pour tous les clients. Chaque clé d'API dispose d'un quota de requêtes qui se réinitialise toutes les heures. Lorsque vous dépassez votre limite, les requêtes renvoient une erreur 429 (Too Many Requests) jusqu'à la réinitialisation.

Limites de débit standards par clé d'API : | Type de limite | Limite | Période de réinitialisation | |----------------|--------|-----------------------------| | Requêtes | 1 000/heure | Toutes les heures | | Pic | 100/minute | Par minute | | Taille de lot | 100 éléments | Par requête | **Limites par endpoint :** • Vérification d'e-mail : 1 000/heure • Recherche d'e-mail : 500/heure • Enrichissement : 200/heure • Recherche de leads : 500/heure • Analyse SEO : 200/heure Besoin de limites plus élevées ? Contactez le support pour discuter d'options entreprise.

Chaque réponse inclut des informations de limite de débit dans les en-têtes : ``` X-RateLimit-Limit: 1000 X-RateLimit-Remaining: 856 X-RateLimit-Reset: 1709046000 Retry-After: 3600 ``` | En-tête | Description | |---------|-------------| | `X-RateLimit-Limit` | Nombre maximum de requêtes autorisées par heure | | `X-RateLimit-Remaining` | Requêtes restantes dans la fenêtre courante | | `X-RateLimit-Reset` | Timestamp Unix de réinitialisation du quota | | `Retry-After` | Secondes avant de pouvoir réessayer (uniquement sur 429) |

Lorsque vous recevez une réponse 429, implémentez une logique de retry : ```javascript async function makeRequest(url, options) { const response = await fetch(url, options); if (response.status === 429) { const retryAfter = response.headers.get('Retry-After') || 60; await sleep(retryAfter * 1000); return makeRequest(url, options); // Réessayer } return response; } ``` **Backoff exponentiel :** En cas d'échecs répétés, utilisez un backoff exponentiel avec jitter : ```javascript const delay = Math.min(baseDelay * 2 ** attempt + randomJitter, maxDelay); ```

Optimisez votre usage de l'API pour éviter les limites de débit : • **Utilisez les endpoints par lots** — vérifiez 100 e-mails en une requête plutôt qu'en 100 requêtes • **Mettez les réponses en cache** — ne récupérez pas des données que vous avez déjà • **Étalez les requêtes** — ne les lancez pas toutes en même temps • **Surveillez les en-têtes** — suivez votre quota restant de façon proactive • **Gérez les erreurs proprement** — mettez en place une logique de retry correcte • **Utilisez les webhooks** — pour les opérations asynchrones, attendez les callbacks plutôt que de poller **Approche par file d'attente :** ```javascript // Traiter les requêtes avec limitation de débit const queue = new RateLimitedQueue({ maxConcurrent: 10, minDelay: 100 // ms entre les requêtes }); await queue.addAll(requests); ```