> For the complete documentation index, see [llms.txt](https://www.boxhero.io/docs/llms.txt). Every page is available as Markdown by appending `.md` to its URL; this page is [Markdown](https://www.boxhero.io/docs/fr/developers/api/rate-limiting.md).

# 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.

## Les limites s’appliquent par équipe

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.

## Lorsque vous atteignez la limite

L’API répond avec `429` et une [enveloppe d’erreur](https://www.boxhero.io/docs/fr/developers/api/errors) dont le `type` est `/errors/too-many-requests`. Les en-têtes de réponse indiquent quand vous pouvez réessayer :

| En-tête | Description |
| --- | --- |
| `Retry-After` | Nombre de secondes à attendre avant de réessayer |
| `RateLimit`, `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset` | La 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.

> **Note**
>
> Les limites peuvent changer. Lisez-les dans les en-têtes de réponse plutôt que de coder un débit en dur dans votre client.