Límites de uso

Cada clave puede hacer 300 peticiones por minuto. Es mucho más de lo que necesita una caja o un quiosco.

Si superas el límite, recibes 429 con una cabecera Retry-After en segundos. Espera ese tiempo y continúa.

JSON

HTTP/1.1 429 Too Many Requests
Retry-After: 60

{
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limited",
    "message": "Too many requests. The limit is 300 per minute per key."
  },
  "request_id": "req_9b1e..."
}

¿Sincronizas una carta grande? Usa POST /v1/menu/items/bulk (hasta 500 platos por llamada) en lugar de una llamada por plato.
¿Consultas si hay pedidos nuevos? Cada 10 o 15 segundos es suficiente. Mejor aún, suscríbete al webhook order.created y consulta solo como respaldo.
¿Reenvías los tickets de un día tras una caída? Envíalos uno detrás de otro, no todos a la vez.