API ecentic : limites de débit.
Chaque réponse publique contient l’état en temps réel de votre fenêtre, afin qu’un agent puisse ajuster son rythme plutôt que de découvrir la limite après un rejet.
En-têtes en temps réel · Retry-After sur 429 · Fenêtres par clé
La politique
Une fenêtre fixe sur la surface publique, comptabilisée par information d’authentification.
publicTous les points de terminaison /api/v1
120requêtes
par 60 secondes
news/api/v1/news
30requêtes
par 60 secondes
news-resolve/api/v1/news?resolve=true
6requêtes
par 60 secondes
Les requêtes contenant une clé bearer sont comptabilisées sur cette clé ; toutes les autres sont comptabilisées sur l’adresse IP du client, afin qu’un agent trop bavard ne puisse pas épuiser le quota d’une adresse partagée.
La fenêtre est fixe, non glissante : elle se réinitialise à une échéance fixe de l’horloge, et la valeur reset dans les en-têtes correspond au nombre de secondes avant cette réinitialisation.
En-têtes
Les deux orthographes sont envoyées. Utilisez celle que votre client comprend déjà.
RateLimit-Policy est toujours présent, car la politique s’applique qu’une requête donnée puisse être comptabilisée ou non. Les compteurs en temps réel ne sont envoyés que lorsqu’un comptage réel existe — un environnement incapable d’accéder au compteur les omet plutôt que de prétendre à un quota jamais mesuré.
Sélectionnez un en-tête pour en comprendre la signification. Ces valeurs illustrent une réponse ; elles ne correspondent pas à un compteur en temps réel.
Signification: La politique active : quota et durée de fenêtre en secondes.
Une limite, deux lectures
Dans cet exemple, les deux formats d’en-tête décrivent la même période.
- Requêtes restantes
- 118
- r=118 · RateLimit-Remaining
- Secondes avant réinitialisation
- 42
- t=42 · RateLimit-Reset
Lorsque vous dépassez la limite
Un 429 est un problème typé comme n’importe quel autre échec.
La réponse est au format application/problem+json avec le code rate-limited, et inclut Retry-After en plus des en-têtes de limitation de débit. Attendez le nombre de secondes indiqué avant de réessayer plutôt que de relancer immédiatement — une nouvelle tentative dans la même fenêtre est comptabilisée et rejetée à nouveau.