Limitation de débit

​

Limites de débit

​

En-têtes de limitation de débit

• X-RateLimit-Limit : Le nombre maximum de requêtes autorisées 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 limitation 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)

​

Gestion des limites de débit

Too many requests

​

Bonnes pratiques

1. Surveiller les limites de débit : Suivez l’en-tête X-RateLimit-Remaining pour anticiper quand vous approchez de la limite.
2. Implémenter un recul : Lorsque vous recevez une réponse 429 :
   • Attendez jusqu’à la date spécifiée dans l’en-tête X-RateLimit-Reset.
   • Envisagez d’implémenter un recul exponentiel pour les nouvelles tentatives.
3. Regrouper 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 cela est approprié pour réduire le nombre d’appels API.

​

Exemples 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