Como usar a PAGINAÇÃO do HTTP REQUEST no N8N | Autotic

E aí automatizador beleza que que você tá achando aí das nossas aulas né sobre desafios de automações aqui do NN você está gostando das aulas está aprendendo bastante não deixa de avaliar lá o nosso curso com uma avaliação positiva deixa também um comentário O que que você tá achando Qual é a sua experiência de aprendizagem tá bom bom então em mais uma aula aqui vamos falar de outra dúvida né que muitos alunos têm com relação à automação aí envolvendo por exemplo requisições né http que é a parte de paginação tá eh eu lembro que bem

no início né Eh a paginação no ntn era era bem complicada por quê Porque você tinha que fazer uma estrutura ali né basicamente um workflow inteiro né só para poder tratar a parte ali de automação né Eh focando aqui na tela do nosso computador como você pode ver aqui tá no site do ntn eh inclusive eles deixam até disponível aqui se você quiser baixar esse template aqui para poder fazer a paginação Então olha o que você tinha que fazer só para poder percorrer todas as páginas ali né de um de uma determinada pii né porque

por exemplo tem api que quando você faz ali um um um get né Eh você não vai retornar todas as informações ali eh de uma vez tá Às vezes as informações elas são separadas por páginas tá então por exemplo cada página consegue retornar por exemplo até 10 registros né 10 itens né E aí para você poder pegar os outros você teria que meio que fazer um loop né como você pode ver aqui aqui é como se fosse um loop né Eh onde ele vai fazendo as requisições aqui eh por página tá é claro que a

página ela vai como um parâmetro ali da URL né uma query né onde você tem tipo um contador né aqui Certamente eles devem usar algum uma variável aqui que vai referenciando essa query de página então por exemplo no primeiro request aqui ele puxa o registro da página um E aí faz a verificação Ah é a última página não aí volta para cá faz o request da página dois aí ele verifica Ah é a última página não aí vai fazendo até concluir tá porque geralmente nessas apis né que tem os registros ali separados por página ele

retorna também um campo onde mostra o total de páginas tá então é esse total de págin que vai mostrar aqui se chegou no fim ou não ali se chegou na última página ou não tá E aí depois que ele percorre todas as páginas né coletando aqui os itens de cada página eh ele chega aqui no final tá e concatena as execuções por no ntn como você já deve ter percebido a cada interação que é feita aqui né no em um loop é gerado uma execução e dentro dessa execução tem ali os respectivos itens então é

como se fosse cada página fosse uma execução tá isso também aqui dificultaria ã para você poder fazer um outro loop né se você por exemplo quiser fazer um outro loop com todos os itens aqui retornados né se você não faz esse merge aqui das execuções você teria dificuldade de eh fazer um loop com todos os itens que foram retornados por quê Porque eles estariam separados por execução tá então isso aqui é o que você deveria fazer para conseguir ali eh em uma única execução todos os registros todos os itens eh de uma determinada pi que

possui paginação Tá e agora o pessoal do ntn conseguiu né deixar isso aqui de uma forma mais simplificada colocando uma função de paginação no próprio node do http request tá então quando você adiciona aqui agora um node http request você vai ver que tem um um apption aqui chamado pagination tá então eu já vou clicar nele aqui para poder abrir tá antes de explicar aqui né O que significa cada parâmetro aqui eu já vou colocar aqui uma url né um end Point aqui de exemplo pra gente poder e fazer esse teste aqui de paginação tá

deixa eu até fechar aqui E aí eu separei e esse end Point aqui ó que é de uma API de teste tá do site hack has pin Ok você acessar lá eles vão ter essa P aqui para você fazer teste tá de paginação E aí eu vou colar aqui essa URL tá vou deixar aqui o método get tá porque a gente tá consultando as informações ali a gente não tá enviando informações pelo endp tá E e aí se eu chegar aqui por exemplo ele tem uma query chamado page tá que seria um como se fosse

uma variável aqui da URL para poder retornar eh a página que tu quer tá então se eu não me engano acho que funciona assim ó quando você vai colocar ali um um um parâmetro né você tem que colocar ponto de interrogação page igual a um tá então se eu executar aqui vamos ver se vai funcionar Ah tá calma aí deixa eu escolhir a a opção pagination não pode dar problema então repara que ele retornou só os itens da página um tá E no caso aqui foram seis seis seis itens tá ó retornou aqui seis itens

aqui fala que Ao Total são 12 itens né e 12 páginas então o que que isso significa que eh seria no máximo aqui duas páginas tá e cada página vai retornar até seis clientes seis usuários digamos assim tá agora se eu chegar aqui e por exemplo alterar para dois tá ó ele vai retornar a página dois com mais seis novos registros tá que seriam mais seis novos clientes OK agora só não sei se esse perpage funcionaria também tá por exemplo se eu chegar aqui botar Ah não tem que botar o o esse e aqui ó

e tá aí eu coloco esse page e coloco por exemplo eh deixa eu ver três eu vou colocar aqui página um tá só para testar aqui Ah tá beleza então olha só que interessante repare que aqui eh ele já retornou eh a primeira página tá E aqui eu limitei a quantidade de itens por página eu eu pedir para ele retornar apenas três itens por página então consequentemente como são 12 páginas aliás como são 12 itens 12 clientes usuários a divisão faz com que fique Quatro páginas Deu para entender por exemplo se eu colocar aqui por

página dois provavelmente aqui vai retornar seis no total de páginas Ok ó retornou seis beleza Claro se eu coloco aqui agora Um item por página vai retornar 12 páginas aqui ó ó 12 páginas e só retornou um um cliente só tá então eu consigo ter esse controle por meio dessas variáveis aqui tá que é página e itens por página tá sendo que para facilitar você não precisa declarar E essas variáveis aqui direto da URL o o http request ele tem aqui é o opção query tá é você informar os parâmetros da query então eu eu

posso muito bem jogar aqui ó eu posso colocar eu quero página igual a um tá e itens por por página eu quero por exemplo quatro se eu executar vai dar no mesmo ó ó lá tá vendo ó Ele retornou a página um com quatro eh itens por página tá eh onde o total são 12 tá E aí na divisão aqui né 12 divido por 4 totalizaria três páginas tá E aqui estão Os Quatros itens né os quatro clientes aqui tá então assim que funcionaria agora como é que eu posso fazer para que isso fique dinâmico

né ao ponto dele conseguir percorrer todas as páginas por exemplo aqui ó vamos fazer o seguinte eu vou colocar aqui para ele retornar para ele retornar dois clientes por página tá justamente ó para fazer com que o total de páginas aqui sejam seis páginas beleza e aí olha só que interessante agora por exemplo e como é que faria agora para você deixar isso aqui de forma dinâmico para ele poder percorrer né porque não tem como você ficar alterando aqui manualmente né Ah agora eu quero a página tal Ah agora quero a página x agora eu

quero a y não tem como você tem que deixar isso de forma dinâmica para que ele consiga percorrer todas as páginas de forma automática tá E aí você agora de fato vai utilizar a opção chamado pagination aqui no seu htp requ que é basicamente uma forma de você ter um contador né Eh na query que tu quer então já que a gente quer percorrer todas as páginas o contador ele deveria deveria não ele deve estar atrelado ao ao parâmetro page né ao parâmetro página tá então o que que eu posso fazer aqui de fato eu

posso manter essa query aqui eh per page né que seria itens por página só apagar essa página aqui tá porque agora a página a gente vai deixar de uma forma dinâmica Ok com com incremento então eu vou escolher aqui e pagination Ok ó como você pode ver aqui tá aqui eu posso manter como eu falei os itens por página tá sem nenhum problema e aqui e ao habilitar essa página aqui p pation mode né Você pode deixar essa opção aqui mesmo tá que é para ele atualizar um parâmetro a cada requisição então a cada vez

que o htp request foi executado é como ele fizesse um incremento ali tá e do do seu parâmetro beleza e aí eu vou colocar aqui qual seria o parâmetro da minha query repare que ele já deixa aqui ó marcado por padrão query tá é claro que você pode botar Campos do do cabeçário ou Campos do corpo tá mas pro padrão a gente vai deixar quer mesmo E aí qual é o nome do meu parâmetro eu quero fazer esse alto incremento page Ok E aí aqui no valor é o seguinte e se você colocar apenas o

valor fixo aqui ele não vai funcionar Tá e por isso que muitas pessoas não não estão sabendo usar essa nova função aqui do do da paginação por aqui de fato você precisa usar uma expressão para que possa ser feito a contabilização toda vez que o htp requ foi executado tá então como é que funcionaria aqui e você vai vai colocar aqui no modo expressão tá E aí você pode né abrir e fechar Chaves duplas e colocar uma variável eh eu ia falar variável fixa né é meio divergente né Eh na verdade você pode colocar aqui

e é uma variável padrão do ntn principalmente aqui pro node http requ que ele retorna para você em tempo real eh a página que tá sendo fe a contagem ali de página né ou seja toda vez que e toda vez que o que o htp request faz uma requisição ele vai incrementando automaticamente essa variável que se chama page count tá então você pode botar aqui ó page count Ok E aí você coloca aqui mais um tá esse page count ele ele é OK e ele começa com zero então por exemplo quando o htp request foi

executado pela primeira vez ele vai pegar o zero do page count vai somar com mais um e esse valor aqui inicialmente vai ser um então é como o ag request fizesse a primeira requisição para a página um tá onde vai retornar dois clientes que foi a limitação que eu coloquei aqui beleza depois em um em uma próxima requisição esse valor aqui já vai ser dois por quê Porque o page count que era zero vai ser um ok E aí vai somar com mais um E aí vai ser dois ou seja ele vai fazer a requisição

da segunda página retornando mais dois clientes mais dois usuários totalizando quatro e assim sucessivamente até chegar à sexta página tá onde ele estaria retornando todos os 12 usuários então é basicamente essa dinâmica tá então muitos usados né que usam aí paginação têm tido dificuldade para poder usar essa funcionalidade por conta desse detalhe aqui tá inclusive isso está na documentação então assim muitas dúvidas dos usuários as respostas estão lá na documentação mas muitos acabam não olhando então não sabem tá então para isso que existe o intensivão ntn justamente para poder tirar essas dúvidas paraa pessoa que

talvez ali né não costuma ler a documentação então não tem muito domínio porque aqui a a gente vai ensinar de uma forma mais simples tá bom eh e aqui em pagination complete eh você pode deixar essa opção aqui response is impat Ou seja quando não retornar mais nenhuma informação tá E aí é muito importante também que você coloque uma limitação de páginas tá porque se você não marcar essa opção aqui né o o teu workflow ele pode entrar ali em timeout ele vai ficar num Loop Infinito porque às vezes api sei lá pode ter sei

lá 1000 páginas né E aí o o ntn vai ficar ali requisitando as 1000 páginas isso pode causar aí um um timeout tá no seu workflow Então por segurança Sempre coloca aqui um valor Tá mesmo que você use o valor aqui padrão 100 não tem problema porque pelo menos já vai dar entender que vai ter um limite Tá mas como Ao Total são 12 páginas então eu posso aliás desculpa como a o total são seis páginas então o valor adequado que eu deveria colocar aqui seria seis ou um valor inferior tá posso colocar cinco posso

colocar quatro Tá mas vamos testar aqui colocando três Ok eu quero que ele vá até a terceira página e pegue o os clientes daquela página tá então pelo cálculo aqui ele deveria retornar seis itens para mim tá bom eh já nesse intervalo aqui eu acredito que deve ter algum bug porque não está funcionando como esperado né mesmo talvez colocando aqui agora também eu não sei se eu tô colocando ah entendi é porque aqui também eu tava colocando pensando que era segundos né então eu tava botando assim ó agora que eu reparei aqui que é em

milissegundos tá então se a gente colocar aqui por exemplo 5000 significa que a cada 5 segundos o hqu vai fazer uma requisição para retornar os itens daquela página Ok é interessante você colocar esse delay aqui porque às vezes pode ter a pi que bloqueia né se vê que você tá fazendo muitas requisições em pouco tempo ali ela pode te bloquear tá então boa prática Sempre coloca aí um intervalo de no mínimo 5 segundos bom em cada requisição Ok então finalizamos aqui tá eu posso até renomear aqui ó retorna clientes das páginas Ok E aí vamos

fazer o teste aqui agora ó eu vou executar ele vai demorar um pouquinho porque ele tá puxando itens de cada página dentro de um intervalo de 5 segundos Então deve levar mais ou menos uns 15 segundos aqui ó mais ou menos uns 15 segundos tá E aí ele retornou três itens aqui Ok eh Por que três itens porque são três páginas Ok não foi o que eu determinei aqui ó que fosse até três páginas se eu colocasse aqui seis ele ia retornar seis itens Ok sendo que em cada item existe uma arrei de clientes ok

que inclusive eu vou falar mais eh no próximo Note que a gente vai usar que é o o item list tá e porque aqui a gente tem que desmembrar para então a gente ter ali o total de clientes então a princípio essa primeira parte aqui ele tá retornando a quantidade de itens que é a quantidade de páginas Ok Inclusive eu posso até colocar aqui ó Na verdade eu posso colocar assim ó e retorna qtd né é quantidade de páginas Ok por exemplo se eu chegar aqui agora e colocar seis ó colocar seis né porque eu

quero que ele retorne os itens de todas as páginas ó vou executar É claro que vai demorar um pouquinho mais né agora deve demorar aí uns 30 segundos né já que é 5 segundos para cada página ele vai retornar aqui seis itens agora tá ó seis itens em 30 segundos aproximadamente e tá aqui ó página 1 página 2 página 3 página 4 página 5 página 6 tá cada página com até dois itens dois clientes ou dois usuários que é o que eu determinei aqui no meu parâmetro per page né ou seja itens por páginas Tá

bom então tudo certinho até o presente momento Hugo como agora eu faço para poder gerar e a lista de clientes tá ou de usuários vou te mostrar aqui agora mas antes só uma observação E lembra que eu te mostrei lá como era feita a paginação no unitn por meio ali do workflow antigamente o htp requ ele não ia gerar é os itens aqui em uma em uma única execução como você pode ver aqui ó aqui é uma execução só tá vendo ó que retornou os seis itens anteriormente esses itens aqui estariam divididos por execução então

já que seria uma página por execução porque é como o htp request executasse aqui seis vezes certo então seriam seis execuções aqui e dentro de cada execução teria apenas uma página Deu para entender e essa função aqui olha que legal ela já agrupa todos os itens em uma única execução Então você também não tem aquela preocupação de agrupar os itens ali em uma única execução né tornar ali múltiplas execuções em uma porque essa função já vai fazer isso para você então essa função aqui é uma mão na roda pessoal muito bom mesmo tá eh e

aí como é que a gente faz agora para poder eh separar né extrair somente a a os clientes ali né a gente pode usar aqui Um item list tá inclusive agora ele tá separado pela função então talvez não vai achar item list mas talvez eu ache split out tá E aí aqui eu tenho que informar o nome do Campo né que eu quero eh extrair os índices né que no caso seria a data Ok então você vê que data aqui ó é do tipo arrei tá por isso que ele tem esse ícone aqui de lista

tá então eu só vou colocar aqui o nome data Ok não é para colocar em forma de expressão tá você vai colocar assim o campo data beleza e aí vou botar aqui ó gera lista de clientes tá só isso tá não preciso fazer mais nada E aí vamos fazer o seguinte para ficar até um pouquinho mais rápido eu vou tirar esse delay aqui tá só pra gente não ter que esperar 30 segundos ó vou salvar vou executar novamente ó retornou os 12 itens né que seria e as seis páginas tá E aqui ó ele concatenou

né ou ele agrupou todos os 12 clientes que foram retornados dessas seis páginas aqui tá então quando a gente abre aqui ó olha que legal agora ele mostra para mim a lista de todos os clientes ó com seus respectivos ids e-mails primeiro nome último nome tá beleza ó É claro aqui você pode definir a quantidade por página né para exibir ó botei 25 é justamente ele exibiu os 12 tá vendo ó e tudo isso aqui ó Prontinho para você já fazer um outro loop aqui para poder talvez por exemplo disparar um e-mail né então por

exemplo se você quisesse disparar um e--mail aqui para todos esses esses clientes né Aí você já poderia né usar aqui o o node splitting Bat que agora né chamado de loop over itens tá você deixa aqui o lote um mesmo para ele fazer a cada cliente ok a gente apaga esse Operation aqui e aqui a gente poderia colocar um sei lá um node send eil né E aí você pode apontar aqui uma credencial ó aí pode botar aqui o remetente né auto E aí o né seria de fato e o e-mail do destinatário que tá

lá na nossa lista de clientes tá antes de referenciar já vou colocar aqui ó teste teste assunto e aqui eu coloco qualquer coisa tá E aí deixa eu só pausar esse node aqui ó vou executar de novo para alimentar aqui meu split betet tá E aqui ó eu já conectaria aqui e aqui ó eu pegaria o e-mail do do usuário tá vendo ó pronto ó então basicamente né por meio aqui da Opção paginação a gente conseguiu retornar todas as páginas de forma dinâmica Ok cada página ali com a sua quantidade x de itens né que

a gente define ali pelo parâmetro por página né per page E aí em seguida a gente extraiu esses itens das seis páginas agrupando eles aqui tudo em em uma única execução tá usando aqui o split out né e depois a gente colocou aqui um uma estrutura de Loop para poder enviar um e-mail para cada um desses clientes que foram retornados Beleza então essa foi a aula sobre paginação se você gostou e não deixe de avaliar depois aí deixa um comentário tá bom E se tiver alguma dúvida pode também deixar aí na na na área de

membra aí da do curso né pra gente poder esclarecer Tá bom então é isso aí um grande abraço e valeu Y