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

Retry-After è l'unico header sul budget. Non c'è nessun X-RateLimit-Remaining da osservare, quindi regoli il ritmo del suo client per 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 recupera la stessa giornata di consegne con un quarto delle richieste necessarie a limit=25. Il costo di una richiesta è la richiesta, non il numero di righe.

Recuperi le fotografie solo quando le servono. Una consegna porta con sé un imageCount. Se è 0, dietro l'endpoint delle immagini non c'è nulla, e chiamarlo è una richiesta spesa per un elenco vuoto.

Serializzi un recupero 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 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 qualsiasi dei primi tre risponde 429 o 400 anziché troncare in silenzio.