Skip to main content
A API Pontua não oferece webhooks customer-facing hoje. Para reagir a novos eventos (uma batida foi registrada, um colaborador foi cadastrado, um relatório ficou pronto), use polling periódico sobre os endpoints REST disponíveis.

Estratégia: polling com cursor

Para minimizar custo e latência, salve um cursor de timestamp no seu lado e use filtros de período disponíveis nos endpoints (quando existirem) para pegar só os novos:
Atenção: o nome dos filtros de período (atualizadoDe, criadoDe, dataInicio, etc.) varia por endpoint. Cheque a Referência da API para o nome correto em cada recurso antes de implementar.

Frequência sugerida de polling

Volumes típicos sem rate limiting agressivo: Não faça polling mais agressivo que 1 req/min por recurso sem um caso extraordinário discutido com sua gerência.

Deduplicação no cliente

Polling com cursor pode trazer o mesmo item 2x em janelas de borda (timestamp = cursor). Trate de forma idempotente:
  • Use o id do recurso como chave de deduplicação no seu lado
  • Se já processou, ignora (loga e segue)
→ Mais detalhes em Idempotência.

Quando webhooks bloqueiam sua integração

Se polling não atende seu caso (latência crítica abaixo de 1 minuto, volume grande de eventos para escalonar consumo), escreva para tecnologia@pontua.com.br descrevendo:
  • Quais eventos você precisaria
  • Volume estimado (eventos/hora)
  • Latência aceitável (segundos vs minutos)
  • Tolerância a duplicatas (at-least-once vs exactly-once)
Esse feedback ajuda a priorizar webhooks no roadmap.