Foto: Olga Tutunaru / Unsplash
Automações
Buscar registros numa API sem seguir a paginação faz a automação processar só a primeira página e ignorar o resto sem dar erro
Pedro Toledo · 8 de novembro de 2026 · 3 min de leitura
Buscar registros numa API sem seguir a paginação faz a automação processar só a primeira página e ignorar o resto sem dar erro — porque muitas APIs devolvem os dados em blocos e a segunda página só aparece se a automação pedir, e quem testou com poucos registros não percebe que a conta passou do limite. Por que o teste pequeno esconder o problema, o que caracteriza seguir a paginação até o fim, e como conferir a contagem.
Uma automação que busca registros parece completa quando o teste dá o resultado esperado. Comparar o total que ela processou com o total que existe na origem mostra se a base inteira entrou na conta.
Buscar registros numa API sem seguir a paginação faz a automação processar só a primeira página e ignorar o resto sem dar erro.
Por que o teste pequeno esconde o problema
Com poucos registros, tudo cabe na primeira página e a automação parece completa. O corte só aparece quando a base cresce além do limite, e a automação segue rodando sem erro, processando uma parte dos dados e deixando o restante de fora, o que costuma ser descoberto quando alguém reclama.
O que caracteriza seguir a paginação até o fim
Seguir é ler a resposta, conferir se há mais páginas, pedir a próxima com o token, a página ou o cursor devolvido e parar só quando não houver mais, registrando quantas páginas foram lidas. Isso tem relação direta com importar milhares de registros de uma vez numa automação sem dividir em lotes — é o mesmo limite visto do outro lado: para ler e para gravar, a API trabalha em blocos, e a automação precisa respeitá-los e contar o que passou.
O que as fontes dizem
A documentação e os fóruns do Airtable que encontrei dizem que a API devolve até 100 registros por requisição e envia um offset para a próxima página. Um caso de fórum do Zapier mostra a automação parando nos 100 primeiros, com a orientação de encadear ações ou guardar o deslocamento, e usuários dizem que o Make pagina sozinho. Não verifiquei o comportamento atual das ferramentas.
Como conferir a contagem
A forma prática é comparar o total esperado com o processado, registrar a quantidade de páginas lidas e ligar um alerta para quando os dois não baterem. Também vale testar uma vez com uma base maior que o limite da API, e não só com três linhas, antes de colocar a automação em produção.
Um exemplo prático
Uma automação envia um e-mail de cobrança para clientes em atraso, lidos de uma tabela. Funciona nos testes, com 40 linhas. Meses depois, a tabela passa de 100 linhas e ninguém percebe que clientes além da centésima nunca recebem o aviso. Ao comparar o total da tabela com o número de e-mails enviados, a equipe vê a diferença e ajusta a leitura.
O ponto central
Antes de confiar na automação, vale perguntar quantos registros existem e quantos ela viu. Quem compara os dois descobre o corte antes de o cliente descobrir.
