Limiti di frequenza

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

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