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 cliente | Valeur |
|---|---|
| Requêtes par seconde | 200, avec de courts pics au-delà |
| Requêtes par minute | 2 000 |
| Connexions ouvertes simultanément | 400 |
Au-delà d'une limite, l'API répond 429 Too Many Requests.
Espacer les tentatives après un 429 ou un 5xx
- Après un
429ou un5xxtemporaire, attendez avant de réessayer. - Doublez l'attente à chaque fois, avec du jitter : environ 1, 2, 4, puis 8 secondes.
- Limitez le nombre de workers simultanés, pour qu'un pic ne se transforme pas en tempête de nouvelles tentatives.
- Réessayez automatiquement les lectures, mais relisez une réservation avant de retenter son annulation.
- 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'usage | Meilleur pattern |
|---|---|
| Chaque appel API | Réutilisez le jeton d'accès jusqu'à son expiration, au lieu d'en demander un à chaque appel |
| Afficher les réservations à venir dans un portail | Mettez les résultats en cache pour une courte durée, et actualisez-les à la demande |
| Tenir un CRM à jour | Utilisez les webhooks au lieu du polling |
| Rattraper l'historique | Planifiez des traitements batch en dehors de vos heures de pointe, et parcourez les résultats page par page |
| Annuler une réservation | Lisez-la une fois, puis annulez seulement après confirmation du participant |