Limites de débit et quotas
Les limites sont attachées à votre plan et décomptées par identifiant de connexion. Les appels REST et les appels d'outils MCP puisent dans le même compteur — un agent et une intégration qui partagent un identifiant partagent son budget, quel que soit le nombre d'établissements qu'il couvre.
Lire les en-têtes
Chaque réponse porte l'état de votre budget, ce qui permet de vous réguler sans attendre d'être refusé :
| En-tête | Signification |
|---|---|
RateLimit-Limit |
Appels autorisés dans la fenêtre courante. |
RateLimit-Remaining |
Appels restants dans cette fenêtre. |
RateLimit-Reset |
Secondes avant la réinitialisation de la fenêtre. |
Surveillez RateLimit-Remaining et ralentissez à l'approche de zéro. Prendre le 429 pour signal de
ralentissement, c'est ralentir une fois déjà refusé.
En cas de dépassement
HTTP/1.1 429 Too Many Requests
Retry-After: 12
Content-Type: application/problem+json
{ "type": "quota/exceeded", "title": "Quota exceeded", "status": 429, … }
Attendez Retry-After secondes. Réessayer plus tôt ne vous fait pas servir plus vite — cela consomme des
tentatives.
Ajoutez de la gigue si plusieurs workers réessaient en même temps : un backoff identique sur une flotte reconstitue exactement la rafale qui vous a fait dépasser la limite.
Limites de charge utile
Votre plan plafonne aussi la taille du corps de requête.
| Statut | type |
Cause |
|---|---|---|
411 |
— | La requête n'a pas de Content-Length. Envoyez-en un. |
413 |
quota/payload-too-large |
Le corps dépasse le plafond du plan ; le detail donne la limite en octets. |
Aucun des deux n'est réessayable en l'état — découpez la charge utile, ou renseignez-vous sur un plan supérieur.
Plans
Les plans sont Free, Standard, Premium et Partner, par allocation croissante. Certains endpoints
peuvent porter leur propre limite, plus stricte et indépendante du plan, quand l'opération sous-jacente est
coûteuse ou sensible — la paie en est le cas évident.
Votre interlocuteur Staff & Go vous indique le plan qui s'applique et ses valeurs concrètes.
Jetons legacy
Les appels authentifiés avec un jeton BearerClient déprécié ne sont pas décomptés et ne reçoivent aucun
en-tête RateLimit. N'y voyez pas une capacité illimitée : cela signifie que vous n'avez aucun signal de
saturation, et aucune protection contre le fait d'être la raison pour laquelle une limite sera resserrée.
Voir Authentification.