# Limiti di frequenza

> Il budget per chiave, l'unico header che lo descrive e come restare al di sotto.

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

L'API Partner consente **300 richieste al minuto per chiave**. La finestra è un
minuto scorrevole, e il budget appartiene alla chiave anziché al ristorante o
alla sua azienda, quindi due deployment con due chiavi hanno due budget.
L'[endpoint MCP](https://developers.backresto.com/it/docs/mcp) attinge allo stesso budget: una chiamata a uno
strumento è una richiesta.

Superarlo risponde `429` con un documento di problema di tipo
`rate-limit-exceeded` e un header `Retry-After` che indica il numero di secondi
prima che il budget si ricarichi. Aspetti che passi; non ritenti prima, perché
una richiesta che arriva in anticipo consuma budget senza andare a buon fine.

`Retry-After` è l'unico header sul budget. Non c'è nessun
`X-RateLimit-Remaining` da osservare, quindi regoli il ritmo del suo client fin
dalla progettazione anziché leggendo un contatore: le abitudini qui sotto sono
quella progettazione.

## Restare comodamente al di sotto

Tre abitudini coprono quasi tutte le integrazioni:

**Chieda pagine piene.** `limit=100` percorre la stessa collezione con un
quarto delle richieste necessarie a `limit=25`. Il costo di una richiesta è
la richiesta, non il numero di righe.

**Recuperi i file solo quando le servono.** Il record di un'immagine dice già
cos'è il file, in `data.asset`: tipo, dimensione e digest. Chiami l'endpoint
degli asset per le immagini che sta per mostrare o conservare, non per ogni
record di un percorso, e salti quelle di cui possiede già lo `sha256`.

**Serializzi un recupero dello storico.** Percorrere un anno di storico con
dieci worker in parallelo è l'unica forma che raggiunge il limite in modo
affidabile. Un solo worker a `limit=100` attraversa l'anno di un ristorante
molto frequentato in un paio di minuti.

## Se le serve davvero di più

Ci dica qual è il carico di lavoro. Il limite esiste per impedire che un client
che si comporta male degradi il servizio per il ristorante di cui sono i dati,
non per razionare l'accesso; un carico di lavoro descritto e legittimo è una
conversazione, non un rifiuto.

## Gli altri limiti da conoscere

| Limite | Valore |
| --- | --- |
| Richieste per chiave | 300 al minuto |
| Dimensione della pagina | 100 record |
| Durata degli URL firmati, fotografie e file | 15 minuti |
| Chiavi attive per account | 10 |

Questi sono imposti dall'API, non semplicemente descritti da essa: superare uno
dei primi due risponde `429` o `400` anziché troncare in silenzio.