Limites de débit
Limites par offre
Chaque espace de travail a un budget par minute et une fenêtre de rafale : au plus 2× le débit moyen sur 10 secondes. Celui qui s’épuise en premier répond 429 rate_limited avec Retry-After. Votre propre usage de l’application ne compte jamais dans le budget de l’API.
| Offre | Par minute | Rafale | Inclus / mois | Tâches simultanées |
|---|---|---|---|---|
| Pro | 60 | 20 / 10 s | 4 000 | 2 |
| Business | 600 | 200 / 10 s | 12 000 | 5 |
| Enterprise | sur mesure | sur mesure | sur mesure | sur mesure |
En-têtes de réponse
X-RateLimit-LimitRequêtes autorisées par minute pour l’espace de travail.X-RateLimit-RemainingRequêtes restantes dans la minute en cours.X-RateLimit-ResetSecondes avant la réinitialisation de la fenêtre d’une minute (pas un horodatage Unix).Retry-AfterSur chaque 429 : secondes à attendre avant de réessayer.X-Request-IdL’identifiant de la requête, aussi présent dans les corps d’erreur. Communiquez-le au support.Idempotent-Replayedtrue quand la réponse est un rejeu d’une requête précédente.Requêtes mensuelles
Chaque offre inclut un nombre de requêtes par mois calendaire (UTC). L’utilisation s’affiche dans Settings → API, à côté de la latence et du taux d’erreur des 30 derniers jours. Un dépassement n’est pas refusé aujourd’hui ; nous annoncerons tout changement ici et dans le journal des modifications avant.
Tâches lourdes
Les séries en masse et les exports ZIP s’exécutent en arrière-plan et partagent les tâches simultanées de l’offre ; les suivantes attendent dans une file. Suivez-les par interrogation ou avec les webhooks bulk.completed et export.completed plutôt qu’en interrogeant en boucle serrée.