Límites de uso (Rate Limiting)

La API aplica límites de peticiones según el plan de tu restaurante.

Límites por plan

	Free	Starter	Professional	Enterprise
Peticiones por día	100	500	2.000	Ilimitado
Peticiones por minuto	10	50	200	Ilimitado
API Keys activas	2	5	20	Ilimitado

Headers de Rate Limit

Cada respuesta incluye headers informativos sobre el estado de tu límite:

Header	Descripción
X-RateLimit-Limit	Límite total de la ventana actual
X-RateLimit-Remaining	Peticiones restantes
X-RateLimit-Reset	Timestamp (Unix epoch en segundos) de cuándo se resetea
Retry-After	(Solo en 429) Segundos que debes esperar antes de reintentar

Ejemplo de respuesta 429

HTTP/1.1 429 Too Many Requests
Retry-After: 45
X-RateLimit-Limit: 10
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1713200060

{
  "success": false,
  "error": "Límite de peticiones excedido (por minuto). Reintenta después.",
  "code": "TOO_MANY_REQUESTS"
}

Buenas prácticas

• Implementa lógica de reintento exponencial (exponential backoff) en tus integraciones.
• Usa el header Retry-After para saber cuánto tiempo esperar antes de reintentar.
• Monitoriza X-RateLimit-Remaining para anticiparte a los límites.