Limites de débit

Les limites de requêtes de l'API, et comment votre client doit espacer ses tentatives quand il les atteint.

1 min de lecture

Les limites s'appliquent par adresse IP cliente : des workers qui partagent une même adresse sortante partagent donc les mêmes limites.

Les limites

Limite, par adresse IP clienteValeur
Requêtes par seconde200, avec de courts pics au-delà
Requêtes par minute2 000
Connexions ouvertes simultanément400

Au-delà d'une limite, l'API répond 429 Too Many Requests.

Espacer les tentatives après un 429 ou un 5xx

  1. Après un 429 ou un 5xx temporaire, attendez avant de réessayer.
  2. Doublez l'attente à chaque fois, avec du jitter : environ 1, 2, 4, puis 8 secondes.
  3. Limitez le nombre de workers simultanés, pour qu'un pic ne se transforme pas en tempête de nouvelles tentatives.
  4. Réessayez automatiquement les lectures, mais relisez une réservation avant de retenter son annulation.
  5. Alertez un opérateur quand le throttling se prolonge.

Un 500 dont le message met en cause votre requête (un external_id manquant, par exemple) échoue de nouveau à chaque tentative. Corrigez plutôt la requête : voir les erreurs de l'API de réservation.

Patterns qui réduisent le throttling

Cas d'usageMeilleur pattern
Chaque appel APIRéutilisez le jeton d'accès jusqu'à son expiration, au lieu d'en demander un à chaque appel
Afficher les réservations à venir dans un portailMettez les résultats en cache pour une courte durée, et actualisez-les à la demande
Tenir un CRM à jourUtilisez les webhooks au lieu du polling
Rattraper l'historiquePlanifiez des traitements batch en dehors de vos heures de pointe, et parcourez les résultats page par page
Annuler une réservationLisez-la une fois, puis annulez seulement après confirmation du participant

Étapes suivantes

Sur cette page