Limites de débit

Plafonds

En-têtes

Chaque réponse porte X-RateLimit-Limit et X-RateLimit-Remaining. Une réponse 429 porte en plus Retry-After, en secondes. Lisez ces en-têtes plutôt que de compter vos appels : le plafond peut changer avec le plan, en cours d'exécution.

HTTP/1.1 429 Too Many Requests
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
Retry-After: 37

{ "error": { "code": "rate_limited",
    "message": "Rate limit of 60 requests per minute exceeded." } }

Par clé, et non par compte

Deux intégrations d'un même compte ne se privent donc pas mutuellement, et l'on peut identifier celle qui consomme. C'est aussi ce qui rend la révocation d'une clé emballée immédiatement bénéfique au reste du compte.

Sur un 429

Attendez le nombre de secondes indiqué par Retry-After, puis réessayez. La fenêtre est fixe : au-delà de ce délai, le compteur est remis à zéro.