# Limites de débit

> Le budget par clé, le seul en-tête qui le décrit, et comment rester en dessous.

Source: https://developers.backresto.com/fr/docs/rate-limits

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](https://developers.backresto.com/fr/docs/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

| Limite | Valeur |
| --- | --- |
| Requêtes par clé | 300 par minute |
| Taille de page | 100 enregistrements |
| Durée de vie d'une URL signée, photographies et fichiers | 15 minutes |
| Clés actives par compte | 10 |

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.