Guides
Rate limits
Quotas par IP et en-têtes retournés par l'API
Documenté dans l'OpenAPI (info.description) :
Quotas
| Portée | Limite |
|---|---|
Endpoints publics (paths ne commençant pas par /admin) | 100 requêtes / minute / IP |
Endpoints admin (paths commençant par /admin) | 1 000 requêtes / minute / IP |
Le quota est par IP, pas par clé API.
429 Too Many Requests
Quand la limite est dépassée, l'API renvoie 429 avec ces en-têtes :
| En-tête | Valeur |
|---|---|
X-RateLimit-Retry-After | Unix timestamp du reset |
X-RateLimit-Limit | Nombre max de requêtes dans la fenêtre courante |
Stratégie recommandée
- Calculer
Retry-After - now()côté client et attendre - Implémenter un backoff exponentiel en cas d'erreur persistante
- Pour des volumes élevés, privilégier les alertes + webhooks plutôt que du polling