Aprenda a paginar chamadas de API usando take, skip e pageCount, tanto no n8n quanto em códigos próprios.
Ao ativar a paginação no n8n, você pode usar o pageCount para identificar qual página está sendo buscada.
Os principais valores são:
take: quantidade máxima de itens buscados em cada chamada.
skip: quantidade de itens que devem ser ignorados antes de iniciar a busca.
pageCount: número da página atual. A contagem começa em 0.
Defina o take como:
take = 1000
Na primeira chamada, o pageCount será 0:
pageCount = 0
skip = 1000 × 0
skip = 0
Assim, o n8n busca os primeiros 1.000 itens.
Na segunda chamada, o pageCount será 1:
pageCount = 1
skip = 1000 × 1
skip = 1000
Agora, o n8n pula os primeiros 1.000 itens e busca os próximos 1.000.
A expressão utilizada no campo skip é:
{{ $pageCount * 1000 }}
A fórmula geral é:
skip = take × pageCount
Para realizar a paginação por meio de um código, como JavaScript ou Python, podemos usar a mesma lógica do n8n.
Primeiro, definimos:
take = 1000: quantidade máxima de itens buscados por chamada.
pageCount = 0: número inicial da página.
skip: quantidade de itens que a API deverá pular.
O valor de skip é calculado assim:
skip = take × pageCount
pageCount = 0
skip = 1000 × 0
skip = 0
A API busca os primeiros 1.000 itens.
pageCount = 1
skip = 1000 × 1
skip = 1000
A API pula os primeiros 1.000 itens e busca os próximos 1.000.
pageCount = 2
skip = 1000 × 2
skip = 2000
A API pula os primeiros 2.000 itens e busca os próximos 1.000.
Depois de cada chamada, o código deve aumentar o pageCount em 1 e repetir a busca.
Como as rotas da API não retornam mais o total de registros (count), devemos verificar quantos itens foram recebidos em cada chamada.
Considerando take = 1000:
Se a API retornar 1.000 itens, pode existir outra página.
Se retornar menos de 1.000 itens, essa é a última página.
Se não retornar nenhum item, não existem mais registros.
A regra é:
Continuar enquanto a quantidade de itens retornados for igual ao take.
Parar quando a quantidade de itens retornados for menor que o take.
Se existirem exatamente 1.000, 2.000 ou 3.000 registros, a última página será retornada completa.
Nesse caso, será necessário fazer mais uma chamada. Ela retornará uma lista vazia, confirmando que não existem mais itens.
Exemplo com exatamente 2.000 registros:
Primeira chamada: 1.000 itens
Segunda chamada: 1.000 itens
Terceira chamada: 0 itens
Ao receber 0 itens na terceira chamada, a paginação deve ser encerrada.
Os itens recebidos em cada chamada devem ser adicionados a uma única lista. No final da paginação, essa lista conterá todos os registros encontrados pela API.