Monitoraggio di endpoint API con webhook

DiffHook offre un monitoraggio di endpoint API costruito attorno ai webhook: punta un monitor a un'API JSON, indica quale JSON path osservare e un POST firmato in HMAC parte nel momento in cui il valore cambia. Non devi costruire un servizio di polling. Non devi mantenere un cron.

La maggior parte dei team finisce per scrivere un piccolo script Node che chiama un endpoint JSON ogni cinque minuti, fa il diff di un campo e pubblica su Slack. Quello script è un punto debole — muore in silenzio, il ricevitore non può verificarne l'autenticità e nessuno si ricorda di aumentare la frequenza prima di un lancio. DiffHook lo sostituisce con un monitor gestito, un contratto webhook firmato e un'API REST che puoi automatizzare da script.

Flusso

Monitora un'API JSON in tre passi

L'intera configurazione si riduce a una chiamata API. Niente SDK, niente file di configurazione, nessuna infrastruttura di polling da mettere in produzione.

01

Crea un monitor JSON API

Invia POST a /v1/monitors con type: 'json_api', l'URL target, un JSON path (ad esempio $.plans[0].price) e un intervallo. DiffHook si occupa di fetch, cache e diff.

02

Scegli una destinazione webhook

Aggiungi un endpoint HTTPS come ricevitore — il tuo backend, un trigger n8n, Slack. I webhook partono con firme HMAC-SHA256, retry automatici e un log di consegna riproducibile.

03

Reagisci al cambio

Quando il JSON path osservato cambia, DiffHook invia un payload strutturato con tipo di evento, URL, vecchio valore, nuovo valore e timestamp. Il tuo codice verifica la firma e agisce.

Esempio API

Un POST, un monitor

Crea un monitor da qualunque linguaggio. L'API REST è identica alla dashboard — tutto ciò che vedi nell'UI è disponibile tramite token.

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

Monitoraggio di endpoint API — domande frequenti

Quali JSON path supporta DiffHook?
Sintassi JSONPath standard: indice di array ($.items[0].price), wildcard ($.products[*].sku) e filtri ($.plans[?(@.name=='pro')].price). Se un campo corrisponde, DiffHook lo tiene d'occhio; quando il valore cambia tra due controlli parte un webhook.
In cosa si differenzia dal monitoraggio di uptime?
Il monitoraggio di uptime scatta quando un endpoint va giù. DiffHook scatta quando la risposta JSON di un endpoint cambia. Due problemi diversi: uptime per 'il servizio è vivo?', DiffHook per 'il dato che mi interessa si è mosso?'. Puoi eseguirli entrambi sulla stessa URL senza conflitti.
DiffHook può monitorare API autenticate?
Sì. Puoi allegare header di richiesta (Authorization, chiavi API, token personalizzati) per ogni monitor. DiffHook li conserva cifrati e li invia a ogni fetch. Puoi ruotarli o revocarli in qualsiasi momento via API.
Con quale frequenza DiffHook controlla?
Fino a ogni 60 secondi nel piano a pagamento. Il piano gratuito è orario. Per il monitoraggio delle API, la maggior parte dei team sta tra 1 e 5 minuti durante i lanci e ogni ora come base — configurabile per ciascun monitor.

Strumenti correlati

Flussi webhook correlati

Manda in pensione lo script di polling

3 monitor gratuiti, controlli da 60 s nel piano a pagamento, webhook firmati in HMAC, API REST completa. Nessuna carta di credito.