Calculadora de paginación de API: cuántas páginas y cuánto tiempo
Calcula cuántas páginas y solicitudes necesitas para traer todos los registros de una API según el tamaño de página, y cuánto tardas con latencia y paralelismo.
Cómo funciona
Páginas = ⌈total de registros ÷ registros por página⌉ · Lotes = ⌈páginas ÷ solicitudes en paralelo⌉ · Tiempo = lotes × tiempo por solicitud
Una API paginada entrega un número fijo de registros en cada respuesta, así que para bajar un conjunto completo necesitas ⌈total ÷ tamaño de página⌉ solicitudes. Siempre se redondea hacia arriba, porque la última página lleva el resto. El tiempo total depende de la latencia de cada solicitud y de cuántas lanzas a la vez: en serie es páginas × latencia, y con paralelismo las solicitudes se agrupan en lotes (redondeando hacia arriba) que corren simultáneamente. Subir el tamaño de página reduce el número de llamadas, pero cada respuesta pesa más y puedes chocar con el límite de tamaño o de tasa de la API; el punto óptimo equilibra ambas cosas.
Ejemplo resuelto
Sofía quiere sincronizar 18,000 pedidos de la API de su tienda en línea, que devuelve 100 por página: ⌈18,000 ÷ 100⌉ = 180 solicitudes, y la última página llega llena con 100 registros. Si cada solicitud tarda 200 ms, hacerlas una por una toma 180 × 0.2 = 36.0 s. Con 4 en paralelo son ⌈180 ÷ 4⌉ = 45 lotes × 0.2 s = 9.0 s.
Preguntas frecuentes
¿Conviene usar páginas más grandes para ir más rápido?
Hasta cierto punto. Menos solicitudes significan menos sobrecarga, pero las respuestas grandes tardan más en generarse y transferirse, y muchas API limitan el tamaño de página a entre 100 y 1,000 registros. Prueba varios tamaños y observa el tiempo de respuesta y la tasa de errores.
¿Cómo afectan los límites de tasa (rate limits)?
Si la API solo acepta cierto número de solicitudes por segundo, ese límite manda sobre tu paralelismo, sin importar cuántos procesos lances. Divide el total de solicitudes entre la tasa permitida para obtener el tiempo mínimo, y aplica reintentos con espera (backoff) ante respuestas 429.
¿La paginación por cursor cambia el número de páginas?
No: sigue siendo total ÷ tamaño de página. Lo que cambia es la velocidad, porque la paginación por cursor (keyset) no obliga a la base de datos a recorrer y saltar las filas anteriores como el offset, así que cada solicitud suele ser más rápida y estable en conjuntos grandes.
¿Qué es un lote de solicitudes?
Es el grupo de páginas que pides al mismo tiempo. Con 4 solicitudes en paralelo y 180 páginas haces 45 lotes; el tiempo total es aproximadamente el número de lotes multiplicado por lo que tarda cada solicitud.
Calculadoras relacionadas
Esta calculadora tiene fines informativos. Verifica los resultados importantes antes de tomar decisiones.