Calculadora de rate limit: cuánto tardas en enviar un lote de peticiones a una API
Convierte el límite de peticiones de una API (rate limit) en peticiones por segundo, por hora y por día, y calcula cuánto tarda en procesarse un lote grande.
Cómo funciona
Ritmo sostenible = límite ÷ ventana · Ventanas = ⌈total ÷ límite⌉ · Tiempo ≈ (ventanas − 1) × ventana
Un límite de N peticiones por ventana fija un techo de N ÷ ventana peticiones por segundo que puedes sostener. Para mandar un lote grande lo divides en ventanas completas: el número de ventanas es el total entre el límite, redondeado hacia arriba. El tiempo transcurrido es más o menos una ventana menos que eso, porque el primer bloque sale de inmediato y solo esperas entre una ventana y la siguiente.
Ejemplo resuelto
Camila integra una API que permite 100 peticiones cada 60 segundos: 100 ÷ 60 ≈ 1.67 req/s, unas 6,000 por hora. Para sincronizar 10,000 registros necesita ⌈10,000 ÷ 100⌉ = 100 ventanas, así que espera 99 × 60 s = 5,940 s, alrededor de 1.7 horas (99 minutos).
Preguntas frecuentes
¿Conviene trabajar justo en el límite?
No. Deja margen: los desfases de reloj, los reintentos y las ráfagas pueden sacarte del límite y provocar respuestas 429 o bloqueos. Apuntar al 80–90% del límite y respetar el encabezado Retry-After es más seguro.
¿Qué diferencia hay entre un límite fijo y una ráfaga (burst)?
Muchas APIs usan un esquema de token bucket que permite ráfagas cortas por encima del promedio mientras el promedio a largo plazo no pase del límite. Esta calculadora modela el ritmo sostenido; una ráfaga permitida te deja superar por poco tiempo la cifra por segundo.
¿Mandar peticiones en paralelo cambia el resultado?
La concurrencia cambia la latencia, no el techo. Si el límite es de 100 por minuto, lanzar 10 peticiones en paralelo sigue gastando 10 de tus 100 llamadas: terminas cada bloque más rápido, pero chocas con el mismo tope por ventana.
¿Qué significa el error 429?
Es el código HTTP «Too Many Requests»: el servidor te avisa que superaste el límite de peticiones. Lo correcto es esperar el tiempo que indica Retry-After o aplicar un backoff antes de reintentar.
Calculadoras relacionadas
Esta calculadora tiene fines informativos. Verifica los resultados importantes antes de tomar decisiones.