Integration · Utvecklare

Larm som signerade webhooks

Varje larm som JSON till din egen endpoint, signerat med HMAC-SHA256 så att du kan bevisa att det kom från Uptimecheck.

14 dagar gratis · Sedan gratis för 5 övervakningar · Inget kreditkort

Det här får du

  • Signerade anrop

    Varje POST har x-uptimecheck-timestamp och x-uptimecheck-signature: en HMAC-SHA256 av tidsstämpeln och bodyn, med kanalens signeringshemlighet som nyckel.

  • Tydliga händelsenamn

    monitor.down, monitor.up, monitor.slow, certificate.expiring, dns.changed med flera, så att din kod kan växla på ett enda fält.

  • En incident, båda ändar

    monitor.down och monitor.up har samma incident-ID, så att du kan öppna och stänga motsvarande post hos dig.

  • Inbyggda omförsök

    Allt annat än ett 2xx-svar inom 10 sekunder försöks igen efter 30 sekunder, 2, 10 och 30 minuter. Ett 410 Gone stoppar nya försök.

Så ansluter du Webhooks

  1. Öppna Alert channels i sidomenyn och välj Add channel.

  2. Välj Webhook och ange Endpoint URL.

  3. Välj Add channel och kopiera signeringshemligheten som visas. Den visas bara en gång.

  4. Välj Send test för att skicka en testhändelse till din endpoint.

Alla fält och en Python-version av kontrollen finns i API-referensen.

Ingår i alla planer, även Free-planen.

Vad som kommer fram

monitor.down
Ett bekräftat avbrott
monitor.up
Återställningen, med nertiden
monitor.slow
Svar över din gräns
monitor.fast
Under gränsen igen
certificate.expiring
Ett TLS-certifikat går snart ut eller har gått ut
domain.expiring
En domänregistrering går snart ut eller har gått ut
dns.changed
Ändrade DNS-poster, med före och efter
server.rebooted
En server med agenten startades om
site.issues
Nya trasiga länkar eller blandat innehåll
site.performance_dropped
En sidas hastighetspoäng för mobil har fallit under din gräns
domain.email_issues
Nya problem med en domäns e-postinställningar
test
Skickat med Skicka test

POST till din 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 samma incident-ID och nertiden i sekunder.

Frågor

Hur verifierar jag signaturen?

Beräkna HMAC-SHA256 över värdet i x-uptimecheck-timestamp, en punkt och den råa request-bodyn, med signeringshemligheten som nyckel. Jämför den i konstant tid med hex-värdet efter sha256= i x-uptimecheck-signature, och avvisa gamla tidsstämplar.

Vilka händelser skickas?

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

Vad händer när min endpoint ligger nere?

En förfrågan som inte får ett 2xx-svar inom 10 sekunder görs om fyra gånger till, efter 30 sekunder, 2 minuter, 10 minuter och 30 minuter. Därefter visar kanalen Not delivering med det senaste felet. Svarar du 410 Gone stoppas omförsöken direkt.

Kan jag se signeringshemligheten igen?

Nej. Den visas en gång, när du lägger till kanalen, och ändras aldrig. För en ny hemlighet lägger du till en ny webhook-kanal och tar bort den gamla.

Kan prenumeranterna på vår statussida följa den här också?

Ja. Besökare på en statussida från Uptimecheck kan följa den i Slack, Microsoft Teams, Discord eller via webhook, för hela sidan eller bara de komponenter de väljer, och få dina statusuppdateringar där.

Ingår det i alla planer?

Ja. Alla larmkanaler utom SMS finns på alla planer, även Free; SMS kräver en betalplan och använder krediter (ingår i Professional och Business, köpta paket på Start). Planerna skiljer sig i hur många larmkanaler du kan lägga till: 3 på Free, 25 på Start, 75 på Professional och 250 på Business.

Driftstopp är historia.

Sätt upp din första övervakning på under en minut, eller ta en titt i livedemon först.

14 dagar gratis · Sedan gratis för 5 övervakningar · Inget kreditkort