# Límites de peticiones

> El presupuesto por clave, la única cabecera que lo describe y cómo no rebasarlo.

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

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](https://developers.backresto.com/es/docs/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

| Límite | Valor |
| --- | --- |
| Peticiones por clave | 300 por minuto |
| Tamaño de página | 100 registros |
| 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 dos
primeros responde `429` o `400` en lugar de truncar en silencio.