Integration · Udviklere

Alarmer som signerede webhooks

Hver alarm som JSON til dit eget endpoint, signeret med HMAC-SHA256, så du kan bevise, at den kom fra Uptimecheck.

14 dages gratis prøveperiode · Derefter gratis med 5 monitorer · Intet betalingskort

Det får du

  • Signerede forespørgsler

    Hver POST har x-uptimecheck-timestamp og x-uptimecheck-signature: en HMAC-SHA256 af tidsstemplet og body'en med kanalens signeringsnøgle som nøgle.

  • Tydelige hændelsesnavne

    monitor.down, monitor.up, monitor.slow, certificate.expiring, dns.changed og flere, så din kode skifter på ét felt.

  • Én hændelse, begge ender

    monitor.down og monitor.up har samme hændelses-ID, så du kan åbne og lukke den tilsvarende post hos dig.

  • Indbyggede genforsøg

    Alt andet end et 2xx-svar inden for 10 sekunder forsøges igen efter 30 sekunder, 2, 10 og 30 minutter. Et 410 Gone stopper genforsøgene.

Sådan forbinder du Webhooks

  1. Åbn Alert channels i sidepanelet, og vælg Add channel.

  2. Vælg Webhook, og indtast Endpoint URL.

  3. Vælg Add channel, og kopiér den signeringsnøgle, der vises. Den vises kun én gang.

  4. Vælg Send test for at sende en testhændelse til dit endpoint.

Alle felter og en Python-version af tjekket findes i API-referencen.

Inkluderet på alle planer, også Free-planen.

Det kommer frem

monitor.down
Et bekræftet nedbrud
monitor.up
Gendannelsen med nedetiden
monitor.slow
Svar over din grænse
monitor.fast
Under grænsen igen
certificate.expiring
Et TLS-certifikat udløber snart eller er udløbet
domain.expiring
En domæneregistrering udløber snart eller er udløbet
dns.changed
Ændrede DNS-poster, med før og efter
server.rebooted
En server med agenten genstartede
site.issues
Nye døde links eller blandet indhold
site.performance_dropped
En sides mobile hastighedsscore faldt under din grænse
domain.email_issues
Nye problemer med et domænes e-mailopsætning
test
Sendt via Send test

POST til dit 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
}
En monitor.down-hændelse. monitor.up har samme incident-ID og nedetiden i sekunder.

Spørgsmål

Hvordan verificerer jeg signaturen?

Beregn HMAC-SHA256 over værdien af x-uptimecheck-timestamp, et punktum og den rå request body med signeringsnøglen som nøgle. Sammenlign det i konstant tid med hex-værdien efter sha256= i x-uptimecheck-signature, og afvis gamle tidsstempler.

Hvilke hændelser sendes?

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

Hvad sker der, når mit endpoint er nede?

En forespørgsel, der ikke får et 2xx-svar inden for 10 sekunder, forsøges igen fire gange mere, efter 30 sekunder, 2 minutter, 10 minutter og 30 minutter. Derefter viser kanalen Not delivering med den seneste fejl. Svarer du 410 Gone, stopper genforsøgene med det samme.

Kan jeg se signeringsnøglen igen?

Nej. Den vises én gang, når du tilføjer kanalen, og den ændres aldrig. For en ny secret skal du tilføje en ny webhook-kanal og slette den gamle.

Kan vores statussides abonnenter også følge med her?

Ja. Besøgende på en Uptimecheck-statusside kan følge den i Slack, Microsoft Teams, Discord eller via webhook, for hele siden eller kun de komponenter, de vælger, og få dine statusopdateringer der.

Er det inkluderet på alle planer?

Ja. Alle alarmkanaler undtagen SMS findes på alle planer, også Free-planen; SMS kræver en betalt plan og bruger kreditter (inkluderet på Professional og Business, købte pakker på Start). Planerne adskiller sig i, hvor mange alarmkanaler du kan tilføje: 3 på Free, 25 på Start, 75 på Professional og 250 på Business.

Nedetid er fortid.

Opret din første monitor på under et minut, eller se dig omkring i livedemoen først.

14 dages gratis prøveperiode · Derefter gratis med 5 monitorer · Intet betalingskort