Rate limiting

Le débit est limité par clé API (pas par organisation) : une organisation peut donc créer plusieurs clés indépendantes sans qu’elles se gênent.

Quotas par plan

Plan	Limite
Free	60 requêtes / minute
Pro	600 requêtes / minute
Business	6000 requêtes / minute

La fenêtre est glissante à la minute.

Headers de réponse

Chaque réponse expose l’état du quota :

X-RateLimit-Limit: 600
X-RateLimit-Remaining: 542
X-RateLimit-Reset: 1747661220

• X-RateLimit-Reset est un timestamp Unix indiquant quand le compteur se réinitialise.

Dépassement

Au-delà du quota, l’API renvoie 429 rate_limited avec un header Retry-After (en secondes) :

HTTP/1.1 429 Too Many Requests
Retry-After: 17

Attendez la durée indiquée avant de réessayer. Implémentez un backoff côté client pour absorber les pics.