Límites de Peticiones

La API de Aleluya impone límites (Rate Limits) de uso para asegurar la estabilidad y equidad de la plataforma.

¿Qué son los rate limits?

Los rate limits son restricciones en el número de peticiones que puedes realizar a la API en un período de tiempo determinado. Esto protege la API de sobrecargas y asegura que todos los usuarios tengan acceso equitativo al servicio.

Límites establecidos

Las violaciones al límite se evalúan en una ventana móvil de 1 minuto (60 segundos) y se aplican a nivel de:

  • Dirección IP: 150 solicitudes por minuto por IP.
  • Usuario: 150 solicitudes por minuto por identificador de usuario autenticado.

Respuesta al exceder el límite

Si tu aplicación alcanza cualquiera de estos límites, las peticiones subsiguientes serán rechazadas con un código de estado 429 Too Many Requests hasta que la ventana de tiempo se restablezca.

Código de estado HTTP

429 Too Many Requests

Cuerpo de respuesta

Si excedes el límite, recibirás un error 429 Too Many Requests:

{
  "error": [
    {
      "message": "Has excedido el límite de solicitudes permitidas. Por favor, intenta de nuevo más tarde.",
      "code": "0001",
      "object": "rate_limit",
      "index": 0
    }
  ]
}

Headers de rate limiting en cada respuesta:

HeaderDescripción
RateLimit-LimitLímite total de peticiones por minuto
RateLimit-RemainingPeticiones restantes en la ventana actual
RateLimit-ResetTimestamp Unix de cuándo se resetea el contador