Límites de peticiones
El presupuesto por clave, la única cabecera que lo describe y cómo no rebasarlo.
La API de partners permite 300 peticiones por minuto y clave. La ventana es un minuto deslizante, y el presupuesto pertenece a la clave, no al restaurante ni a su empresa, así que dos despliegues con dos claves tienen dos presupuestos. El endpoint MCP consume del mismo presupuesto: una llamada a una herramienta es una petición.
Pasarse responde 429 con un documento de problema de tipo
rate-limit-exceeded y una cabecera Retry-After que indica el número de
segundos hasta que se recarga el presupuesto. Espere a que pase; no reintente
antes, porque una petición que llega pronto consume presupuesto sin tener éxito.
Retry-After es la única cabecera de presupuesto. No hay ningún
X-RateLimit-Remaining que vigilar, así que regule el ritmo de su cliente por
diseño en lugar de leyendo un contador: los hábitos de abajo son ese diseño.
Mantenerse por debajo con holgura
Tres hábitos cubren casi cualquier integración:
Pida páginas completas. limit=100 obtiene el mismo día de entregas con la
cuarta parte de las peticiones que necesita limit=25. El coste de una petición
es la petición, no el número de filas.
Pida las fotografías solo cuando las necesite. Una entrega lleva un
imageCount. Si es 0, no hay nada detrás del endpoint de imágenes, y llamarlo
es una petición gastada en una lista vacía.
Serialice el relleno histórico. Recorrer un año de historial con diez procesos
en paralelo es la única forma que da con el límite sin falta. Un solo proceso con
limit=100 recorre el año de un restaurante con mucho movimiento en un par de
minutos.
Si de verdad necesita más
Díganos cuál es la carga de trabajo. El límite existe para evitar que un cliente que se porta mal degrade el servicio del restaurante de quien son los datos, no para racionar el acceso; una carga de trabajo legítima y descrita es una conversación, no una negativa.
Los demás límites que conviene conocer
| Límite | Valor |
|---|---|
| Peticiones por clave | 300 por minuto |
| Tamaño de página | 100 entregas, o 100 registros |
| Rango de tiempo por petición de listado de entregas | 366 días |
| Fotografías por entrega | 20 |
| Vida útil de la URL firmada, fotografías y archivos | 15 minutos |
| Claves activas por cuenta | 10 |
La API los aplica, no se limita a describirlos: superar cualquiera de los tres
primeros responde 429 o 400 en lugar de truncar en silencio.