Limites de débit

L'API Partenaire autorise 300 requêtes par minute et par clé. La fenêtre est une minute glissante, et le budget appartient à la clé plutôt qu'au restaurant ou à votre société : deux déploiements avec deux clés ont donc deux budgets. L'endpoint MCP puise dans le même budget : un appel d'outil est une requête.

Le dépassement répond 429 avec un document problème de type rate-limit-exceeded et un en-tête Retry-After qui donne le nombre de secondes avant que le budget ne se recharge. Attendez ; ne réessayez pas plus tôt, parce qu'une requête qui arrive en avance consomme du budget sans réussir.

Retry-After est le seul en-tête de budget. Il n'y a pas de X-RateLimit-Remaining à surveiller : réglez donc le rythme de votre client par conception plutôt qu'en lisant un compteur. Les habitudes ci-dessous sont cette conception.

Rester confortablement en dessous

Trois habitudes couvrent presque toutes les intégrations :

Demandez des pages pleines. limit=100 parcourt la même collection en un quart des requêtes qu'il faut à limit=25. Le coût d'une requête, c'est la requête, pas le nombre de lignes.

Ne récupérez les fichiers que quand vous en avez besoin. L'enregistrement d'une photo dit déjà ce qu'est le fichier, dans data.asset : type, taille et empreinte. Appelez l'endpoint des fichiers pour les photos que vous vous apprêtez à afficher ou à stocker, pas pour chaque enregistrement d'un parcours, et sautez celles dont vous détenez déjà le sha256.

Sérialisez une reprise d'historique. Parcourir un an d'historique avec dix workers en parallèle est la seule forme qui atteint la limite à coup sûr. Un seul worker à limit=100 traverse l'année d'un restaurant chargé en deux ou trois minutes.

Si vous avez réellement besoin de plus

Dites-nous en quoi consiste la charge de travail. La limite existe pour empêcher un client mal élevé de dégrader le service pour le restaurant à qui appartiennent les données, pas pour rationner l'accès ; une charge de travail décrite et légitime, c'est une conversation, pas un refus.

Les autres limites à connaître

Elles sont appliquées par l'API plutôt que décrites par elle : dépasser l'une des deux premières répond 429 ou 400 plutôt que de tronquer en silence.