O que é Polling?

O que é polling

Polling é a consulta repetida a um serviço para descobrir mudanças ou acompanhar o andamento de uma tarefa. A integração faz uma consulta, interpreta a resposta e volta a perguntar depois do intervalo definido, até encontrar a informação necessária ou encerrar o acompanhamento.

Você pode usar esse mecanismo para verificar se um relatório ficou pronto ou se apareceram novas inscrições em uma plataforma. No primeiro caso, as consultas acompanham uma tarefa específica, enquanto no segundo a rotina pode continuar procurando novidades por tempo indeterminado.

O intervalo define parte da espera

Uma mudança que acontece logo depois da consulta pode ficar sem ser percebida até a próxima tentativa. Consultar com maior frequência reduz essa espera potencial, mas também aumenta o número de chamadas que a integração faz ao serviço.

Uma consulta a cada cinco minutos representa doze chamadas por hora em um exemplo sem falhas, antes de considerar paginação ou novas tentativas. Quando cada busca precisa percorrer quatro páginas, o volume pode chegar a quarenta e oito chamadas no mesmo período.

Esse cálculo permite comparar a frequência desejada com o rate limit da API. O intervalo do agendamento não garante o prazo de detecção, porque indisponibilidade, lentidão e tempo de processamento também entram na espera real.

A retomada precisa considerar o que foi processado

Uma integração pode guardar um cursor de mudanças ou um marcador de atualização fornecido pela origem. Esse marcador indica de onde continuar e deve avançar somente depois de concluir o processamento correspondente, para que uma interrupção permita recuperar o trecho pendente.

Filtros por data exigem conferir se o início e o fim do intervalo entram na consulta, inclusive quando várias atualizações compartilham o mesmo horário. Reconsultar uma pequena faixa anterior e reconhecer os registros já tratados pode ser necessário, dependendo das garantias da API e da precisão de seus horários.

Também é preciso percorrer todas as páginas necessárias. Se a coleção tiver várias páginas e a integração gravar o horário atual como concluído depois da primeira resposta, as páginas restantes podem ficar sem processamento mesmo que a chamada tenha retornado sucesso.

Consultar o estado atual não revela todo o histórico

Se um item muda duas vezes entre consultas, uma API que devolve apenas o estado atual pode mostrar somente a última versão. Para acompanhar cada ocorrência intermediária, você precisa de uma fonte que preserve esse histórico, como uma lista de eventos ou um registro de alterações.

Algumas APIs permitem consultas condicionais, que evitam transferir novamente uma representação inalterada. A documentação do GitHub, por exemplo, explica o uso de ETag e da resposta 304 Not Modified, mas o efeito sobre a cota de chamadas depende do serviço e das condições documentadas.

Como conferir a rotina de consulta

Compare os horários da mudança na origem e da descoberta pela integração. Acompanhe a posição de retomada após uma falha e use uma coleção distribuída em duas páginas para conferir se ambas são processadas.

Antes de reduzir o intervalo para detectar mudanças mais cedo, confira a cota de chamadas disponível. Quando a origem oferece webhooks, eles podem comunicar as mudanças, enquanto o polling permanece como uma conferência periódica do que deveria estar sincronizado.

Aplicação na formação

n8n Experts

O polling consulta periodicamente um serviço para detectar mudanças, relacionando frequência e atraso de detecção.

Conhecer a formação →