Inizia la prova gratuita

Integrazione · Sviluppatori

Avvisi come richieste firmate webhook

Ogni avviso come JSON al tuo endpoint, firmato con HMAC-SHA256 così puoi dimostrare che arriva da Uptimecheck.

Inizia la prova gratuita Prova la demo live

Prova gratuita di 14 giorni · Poi gratis con 5 monitor · Nessuna carta di credito

Cosa ottieni

  • Richieste firmate

    Ogni POST include x-uptimecheck-timestamp e x-uptimecheck-signature: un HMAC-SHA256 del timestamp e del corpo, con il signing secret del canale come chiave.

  • Nomi di evento chiari

    monitor.down, monitor.up, monitor.slow, certificate.expiring, dns.changed e altri, così il tuo codice decide in base a un solo campo.

  • Un incidente, entrambi i lati

    monitor.down e monitor.up hanno lo stesso ID incidente, così puoi aprire e chiudere il record corrispondente dalla tua parte.

  • Tentativi ripetuti integrati

    Qualsiasi risposta diversa da 2xx entro 10 secondi viene ritentata dopo 30 secondi, 2, 10 e 30 minuti. Un 410 Gone interrompe i tentativi.

Come collegare Webhook

  1. Apri Alert channels nella barra laterale e scegli Add channel.

  2. Scegli Webhook e inserisci l’Endpoint URL.

  3. Scegli Add channel e copia il signing secret che compare. Viene mostrato una sola volta.

  4. Scegli Send test per inviare un evento di prova al tuo endpoint.

Tutti i campi e una versione Python della verifica sono nel riferimento API.

Incluso in ogni piano, anche nel piano Free.

Configuralo Come impostare e verificare gli avvisi webhook

Cosa arriva

monitor.down
Un disservizio confermato
monitor.up
Il ripristino, con la durata del downtime
monitor.slow
Risposte oltre il tuo limite
monitor.fast
Di nuovo sotto il limite
certificate.expiring
Un certificato TLS sta per scadere o è scaduto
domain.expiring
La registrazione di un dominio sta per scadere o è scaduta
dns.changed
Record DNS modificati, con prima e dopo
server.rebooted
Un server con l’agent è stato riavviato
site.issues
Nuovi link non funzionanti o contenuti misti
site.performance_dropped
Il punteggio di velocità mobile di una pagina è sceso sotto la tua soglia
domain.email_issues
Nuovi problemi nella configurazione email di un dominio
test
Inviato da Invia test

POST al tuo endpoint

x-uptimecheck-timestamp: 1792120324
x-uptimecheck-signature: sha256=5d2c…e81f

{
  "event": "monitor.down",
  "workspace": "Northwind",
  "monitor": {
    "id": "mon_9xk2m1q8w4",
    "name": "Checkout",
    "target": "https://northwind.shop/checkout",
    "url": "https://app.uptimecheck.com/w/northwind/monitors/mon_9xk2m1q8w4"
  },
  "incident": {
    "id": "inc_7b3t9r2m5c",
    "url": "https://app.uptimecheck.com/w/northwind/incidents/inc_7b3t9r2m5c"
  },
  "cause": "HTTP 502",
  "regions": ["eu-north"],
  "at": "2026-10-16T03:12:04.000Z",
  "downtimeSeconds": null,
  "explanation": null
}
Un evento monitor.down. monitor.up riporta lo stesso ID incidente e il downtime in secondi.

Domande

Come verifico la firma?

Calcola un HMAC-SHA256 sul valore di x-uptimecheck-timestamp, un punto e il corpo grezzo della richiesta, usando come chiave il signing secret. Confrontalo in tempo costante con il valore esadecimale dopo sha256= in x-uptimecheck-signature, e rifiuta i timestamp vecchi.

Quali eventi vengono inviati?

monitor.down, monitor.up, monitor.slow, monitor.fast, certificate.expiring, domain.expiring, dns.changed, server.rebooted, site.issues, site.performance_dropped, domain.email_issues e test.

Cosa succede se il mio endpoint è offline?

Una richiesta che non riceve una risposta 2xx entro 10 secondi viene ritentata altre quattro volte, dopo 30 secondi, 2 minuti, 10 minuti e 30 minuti. Dopo di che il canale mostra Non consegnato con l’ultimo errore. Rispondere 410 Gone interrompe subito i tentativi.

Posso rivedere il signing secret?

No. Viene mostrato una sola volta, quando aggiungi il canale, e non cambia mai. Per un nuovo secret, aggiungi un nuovo canale webhook ed elimina quello vecchio.

Gli iscritti alla nostra pagina di stato possono seguirlo anche qui?

Sì. I visitatori di una pagina di stato Uptimecheck possono seguirla su Slack, Microsoft Teams, Discord o via webhook, per l’intera pagina o solo per i componenti che scelgono, e ricevere lì i tuoi aggiornamenti di stato.

È incluso in ogni piano?

Sì. Tutti i canali di avviso tranne gli SMS sono inclusi in ogni piano, anche nel piano Free; gli SMS richiedono un piano a pagamento e usano crediti (inclusi in Professional e Business, pacchetti da acquistare su Start). I piani differiscono per il numero di canali di avviso che puoi aggiungere: 3 su Free, 25 su Start, 75 su Professional e 250 su Business.

Funziona bene con

Tutte le integrazioni

I disservizi sono acqua passata.

Configura il tuo primo monitor in meno di un minuto, oppure esplora prima la demo live.

Inizia la prova gratuita Confronta i piani

Prova gratuita di 14 giorni · Poi gratis con 5 monitor · Nessuna carta di credito