Monitoramento de endpoints de API com webhooks

O DiffHook é monitoramento de endpoints de API construído em torno de webhooks: aponte um monitor para uma API JSON, diga qual caminho JSON observar, e um POST assinado em HMAC dispara no momento em que o valor muda. Você não constrói um serviço de polling. Você não mantém um cron.

A maioria dos times acaba escrevendo um pequeno script em Node que chama um endpoint JSON a cada cinco minutos, faz diff de um campo e posta no Slack. Esse script vira um passivo — morre em silêncio, o receptor não verifica a autenticidade e ninguém lembra de aumentar a frequência antes de um lançamento. O DiffHook substitui tudo isso por um monitor gerenciado, um contrato de webhook assinado e uma API REST que você pode automatizar via script.

Fluxo

Monitore uma API JSON em três passos

A configuração inteira é uma chamada de API. Sem SDK, sem arquivo de configuração, sem infraestrutura de polling para manter.

01

Criar um monitor JSON API

Faça POST em /v1/monitors com type: 'json_api', a URL alvo, um JSON path (ex.: $.plans[0].price) e um intervalo. O DiffHook cuida do fetch, do cache e do diff.

02

Escolher um destino webhook

Adicione qualquer endpoint HTTPS como receptor — seu backend, um gatilho do n8n, o Slack. Os webhooks vêm com assinaturas HMAC-SHA256, reenvio automático em caso de falha e um log de entregas que você pode reprocessar.

03

Reagir à mudança

Quando o JSON path observado muda, o DiffHook envia um payload estruturado com tipo do evento, URL, valor anterior, novo valor e timestamp. Seu código verifica a assinatura e reage.

Exemplo de API

Um POST, um monitor

Crie um monitor a partir de qualquer linguagem. A API REST é idêntica ao painel — tudo o que você vê na interface está disponível via tokens.

POST /v1/monitors
{
  "type": "json_api",
  "url":  "https://api.example.com/v1/pricing",
  "json_path": "$.plans[0].price",
  "interval_seconds": 60,
  "deliveries": [
    { "type": "webhook", "url": "https://your-app.com/hooks/pricing" }
  ]
}

FAQ

Monitoramento de endpoints de API — perguntas frequentes

Quais JSON paths o DiffHook suporta?
Sintaxe JSONPath padrão: índice de array ($.items[0].price), curingas ($.products[*].sku) e filtros ($.plans[?(@.name=='pro')].price). Se um campo corresponde, o DiffHook acompanha; quando o valor muda entre duas verificações, um webhook é disparado.
Qual a diferença para monitoramento de uptime?
O monitoramento de uptime dispara quando um endpoint cai. O DiffHook dispara quando a resposta JSON de um endpoint muda. Problemas diferentes: uptime responde 'o serviço está no ar', DiffHook responde 'o dado que me interessa mudou'. Dá para rodar os dois na mesma URL sem conflito.
O DiffHook consegue monitorar APIs autenticadas?
Sim. Defina headers de requisição (Authorization, chaves de API, tokens personalizados) por monitor. O DiffHook os armazena criptografados e os envia em cada requisição. Rotacione ou revogue a qualquer momento via API.
Com que velocidade o DiffHook verifica?
Até a cada 60 segundos no plano pago. O plano gratuito verifica de hora em hora. Para monitoramento de API, a maioria dos times fica entre 1 e 5 minutos durante lançamentos e em intervalos de uma hora fora disso — configurável por monitor.

Ferramentas relacionadas

Fluxos webhook relacionados

Aposente de vez aquele script de polling

3 monitores grátis, verificações de 60 s no pago, webhooks assinados em HMAC, API REST completa. Sem cartão de crédito.