Aprenda a paginar llamadas de API usando take, skip y pageCount, tanto en n8n como en códigos propios.
Al activar la paginación en n8n, puede usar pageCount para identificar qué página se está buscando.
Los valores principales son:
take: cantidad máxima de elementos buscados en cada llamada.
skip: cantidad de elementos que deben ignorarse antes de iniciar la búsqueda.
pageCount: número de la página actual. El conteo comienza en 0.
Defina take como:
take = 1000
En la primera llamada, el pageCount será 0:
pageCount = 0
skip = 1000 × 0
skip = 0
Así, n8n busca los primeros 1.000 elementos.
En la segunda llamada, el pageCount será 1:
pageCount = 1
skip = 1000 × 1
skip = 1000
Ahora, n8n omite los primeros 1.000 elementos y busca los próximos 1.000.
La expresión utilizada en el campo skip es:
{{ $pageCount * 1000 }}
La fórmula general es:
skip = take × pageCount
Para realizar la paginación a través de un código, como JavaScript o Python, podemos usar la misma lógica de n8n.
Primero, definimos:
take = 1000: cantidad máxima de elementos obtenidos por llamada.
pageCount = 0: número inicial de la página.
skip: cantidad de elementos que la API debe omitir.
El valor de skip se calcula así:
skip = take × pageCount
pageCount = 0
skip = 1000 × 0
skip = 0
La API busca los primeros 1.000 elementos.
pageCount = 1
skip = 1000 × 1
skip = 1000
La API omite los primeros 1.000 elementos y busca los siguientes 1.000.
pageCount = 2
skip = 1000 × 2
skip = 2000
La API omite los primeros 2.000 elementos y busca los siguientes 1.000.
Después de cada llamada, el código debe aumentar pageCount en 1 y repetir la búsqueda.
Como las rutas de la API ya no devuelven el total de registros (count), debemos verificar cuántos elementos se recibieron en cada llamada.
Considerando take = 1000:
Si la API devuelve 1.000 elementos, puede existir otra página.
Si devuelve menos de 1.000 elementos, esta es la última página.
Si no devuelve ningún elemento, no existen más registros.
La regla es:
Continuar mientras la cantidad de elementos devueltos sea igual al take.
Parar cuando la cantidad de elementos devueltos sea menor que el take.
Si existen exactamente 1.000, 2.000 o 3.000 registros, la última página será devuelta completa.
En ese caso, será necesario hacer una llamada más. Devolverá una lista vacía, confirmando que no existen más elementos.
Ejemplo con exactamente 2.000 registros:
Primera llamada: 1.000 elementos
Segunda llamada: 1.000 elementos
Tercera llamada: 0 elementos
Al recibir 0 elementos en la tercera llamada, la paginación debe ser finalizada.
Los elementos recibidos en cada llamada deben agregarse a una única lista. Al final de la paginación, esta lista contendrá todos los registros encontrados por la API.