Limites de débit

Les limites de débit maintiennent une performance prévisible pour le tenant. Elles sont appliquées par clé API sur une fenêtre fixe de 60 secondes.

Paliers

Palier	Requêtes / minute
`standard` (par défaut)	120
`elevated`	600

Le palier de votre clé et le budget actuel sont signalés par GET /v1/auth/context (rate_limit_tier) et GET /v1/usage (rate_limit.limit_per_minute et rate_limit.remaining_per_minute). Lisez toujours les valeurs en direct plutôt que de les coder en dur.

Lorsque vous dépassez la limite

Les requêtes au-delà de la limite renvoient 429 avec code: "RATE_LIMITED". Appliquez un backoff et réessayez après la réinitialisation de la fenêtre.

Concevoir dans le respect des limites

Mettez en cache les données de référence et préférez les synchronisations incrémentielles à l'interrogation de tables complètes.
Utilisez les webhooks pour des mises à jour pilotées par événements au lieu de l'interrogation.
Appliquez un backoff sur 429 et évitez les tempêtes de nouvelles tentatives parallèles après des échecs transitoires.
Combinez les filtres (search, status, module) pour récupérer moins de données.

Limites de débit

Les limites de débit maintiennent une performance prévisible pour le tenant. Elles sont appliquées par clé API sur une fenêtre fixe de 60 secondes.

Paliers

Palier	Requêtes / minute
`standard` (par défaut)	120
`elevated`	600

Lorsque vous dépassez la limite

Les requêtes au-delà de la limite renvoient 429 avec code: "RATE_LIMITED". Appliquez un backoff et réessayez après la réinitialisation de la fenêtre.

Concevoir dans le respect des limites

Mettez en cache les données de référence et préférez les synchronisations incrémentielles à l'interrogation de tables complètes.
Utilisez les webhooks pour des mises à jour pilotées par événements au lieu de l'interrogation.
Appliquez un backoff sur 429 et évitez les tempêtes de nouvelles tentatives parallèles après des échecs transitoires.
Combinez les filtres (search, status, module) pour récupérer moins de données.