Passer au contenu principal
Notre API implémente une limitation du débit pour garantir une utilisation équitable et protéger le système contre les abus. Cette page détaille nos politiques de limitation du débit et comment les gérer efficacement.

​
Limites de débit

​
API principale

Type d’opérationLimiteFenêtre
Lecture (GET)20010 secondes
Écriture (POST, PUT, PATCH, DELETE)5010 secondes

​
API d’ingestion d’événements

L’API d’ingestion d’événements possède des limites de débit distinctes :
Type d’opérationLimiteFenêtre
Toutes les requêtes1 00010 secondes
De plus, les limites de taille de charge utile suivantes s’appliquent :
  • POST /v1/events/batch : maximum de 5 000 événements par requête
  • DELETE /v1/events : maximum de 5 000 ID d’événements par requête

​
En-têtes de limite de débit

Les réponses de l’API incluent les en-têtes de limite de débit suivants :
  • X-RateLimit-Limit : le nombre maximum de requêtes autorisé dans la fenêtre actuelle
  • X-RateLimit-Remaining : le nombre de requêtes restantes dans la fenêtre actuelle
  • X-RateLimit-Reset : la date et l’heure auxquelles la fenêtre de limite de débit se réinitialise
  • Retry-After : le nombre minimum de secondes à attendre avant de réessayer (uniquement lorsque la limite a été atteinte)

​
Gérer les limites de débit

Lorsque vous dépassez la limite de débit, l’API renvoie un code de statut HTTP 429 Too Many Requests. Le corps de la réponse sera : 
Too many requests

​
Bonnes pratiques

  1. Surveillez les limites de débit : suivez l’en-tête X-RateLimit-Remaining pour anticiper le moment où vous approchez de la limite
  2. Implémentez un backoff : lorsque vous recevez une réponse 429 :
    • Attendez jusqu’à la date spécifiée dans l’en-tête X-RateLimit-Reset
    • Envisagez de mettre en œuvre un backoff exponentiel pour les nouvelles tentatives
  3. Regroupez les requêtes : lorsque c’est possible, combinez plusieurs opérations en une seule requête
  4. Mise en cache : mettez en cache les réponses lorsque c’est approprié pour réduire le nombre d’appels API

​
Exemple d’en-têtes de réponse

Limite de débit non dépassée : 
HTTP/1.1 200 OK
X-RateLimit-Limit: 200
X-RateLimit-Remaining: 150
X-RateLimit-Reset: 2025-04-15T10:18:08.107Z
Limite de débit dépassée : 
HTTP/1.1 429 Too Many Requests
X-RateLimit-Limit: 200
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 2025-04-15T10:18:08.107Z
Retry-After: 5

​
Limites de débit personnalisées

Si votre application nécessite des limites de débit plus élevées, veuillez contacter notre équipe de support. Nous travaillerons avec vous pour établir des limites appropriées en fonction de votre cas d’usage.