Aller au contenu

Limitation du débit

Comment l’API BoxHero limite le débit des requêtes par équipe, et comment temporiser puis réessayer.

Pour que le service reste stable pour tous, l’API BoxHero limite le nombre de requêtes qu’une équipe peut envoyer.

Tous les jetons d’API d’une même équipe partagent les mêmes limites. Générer davantage de jetons dans une équipe n’augmente pas la limite.

L’API répond avec 429 et une enveloppe d’erreur dont le type est /errors/too-many-requests. Les en-têtes de réponse indiquent quand vous pouvez réessayer :

En-têteDescription
Retry-AfterNombre de secondes à attendre avant de réessayer
RateLimit, X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-ResetLa limite actuelle, le nombre de requêtes restantes et le moment où la limite est réinitialisée

Patientez et réessayez une fois le délai indiqué dans Retry-After écoulé. Si vous envoyez de nombreuses requêtes à la suite, étalez-les au lieu de les envoyer toutes en même temps.