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:
| Header | Descripción |
|---|---|
RateLimit-Limit | Límite total de peticiones por minuto |
RateLimit-Remaining | Peticiones restantes en la ventana actual |
RateLimit-Reset | Timestamp Unix de cuándo se resetea el contador |
Updated about 1 month ago