Rate limits

Deux buckets s'appliquent à /v1/* :

Limite d'ingest par clé

POST /v1/events : 1200 requêtes par minute par clé API (par défaut). Quand tu dépasses, le serveur renvoie 429 RATE_LIMITED.

Cette limite est généreuse parce que l'ingest est le hot path. Upgrade ton plan ou contacte le support si tu la touches régulièrement.

Limite globale par IP

Tous les autres endpoints : 1500 requêtes par minute par IP. Même forme de réponse 429.

Headers de réponse

On renvoie les headers IETF RateLimit standards sur chaque réponse :

RateLimit-Limit: 1200
RateLimit-Remaining: 973
RateLimit-Reset: 45

Utilise-les pour faire du back-off gracieux. Le SDK fait du backoff exponentiel automatique sur 429.