Rate Limiting

L'API limite le nombre de requêtes par clé API pour assurer la stabilité.

Limites

• 1000 requêtes par heure par défaut
• Basé sur un algorithme token bucket avec Redis

Headers de réponse

Chaque réponse inclut des headers de rate limiting :

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 987
X-RateLimit-Reset: 1642435200

• X-RateLimit-Limit : Nombre max de requêtes par heure
• X-RateLimit-Remaining : Requêtes restantes
• X-RateLimit-Reset : Timestamp Unix de réinitialisation

Erreur 429

Si vous dépassez la limite :

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded. Try again in 3600 seconds"
  }
}

Le header Retry-After indique le nombre de secondes à attendre.

Bonnes pratiques

• Implémentez un backoff exponentiel
• Surveillez le header X-RateLimit-Remaining
• Espacez vos requêtes si possible