Aller au contenu

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é

01

La politique

Une fenêtre fixe sur la surface publique, comptabilisée par information d’authentification.

public

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

Politiques appliquées par l’API
02

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.

En-têteExemple

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
03

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.

Exemple : réponse 429