Límites de peticiones

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 leer 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 recorre la misma colección 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 los archivos solo cuando los necesite. El registro de una foto ya dice qué es el archivo, en data.asset: tipo, tamaño y resumen criptográfico. Llame al endpoint de archivos adjuntos para las fotos que vaya a mostrar o guardar, no para cada registro de un recorrido, y sáltese aquellas cuyo sha256 ya tenga.

Serialice la carga del histórico. Recorrer un año de historial con diez procesos en paralelo es el único patrón 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 para el 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

La API los aplica, no se limita a describirlos: superar cualquiera de los dos primeros responde 429 o 400 en lugar de truncar en silencio.