Integrasjon · Utviklere

Varsler som signerte webhooks

Alle varsler som JSON til ditt eget endepunkt, signert med HMAC-SHA256 så du kan bevise at de kom fra Uptimecheck.

14 dagers gratis prøveperiode · Deretter gratis for 5 monitorer · Uten kredittkort

Hva du får

  • Signerte forespørsler

    Hver POST har x-uptimecheck-timestamp og x-uptimecheck-signature: en HMAC-SHA256 av tidsstempelet og innholdet, med kanalens signeringsnøkkel som nøkkel.

  • Tydelige hendelsesnavn

    monitor.down, monitor.up, monitor.slow, certificate.expiring, dns.changed med flere, så koden din styrer etter ett felt.

  • Én hendelse, begge ender

    monitor.down og monitor.up har samme hendelses-ID, så du kan åpne og lukke den tilhørende posten hos deg.

  • Innebygde nye forsøk

    Alt annet enn et 2xx-svar innen 10 sekunder prøves på nytt etter 30 sekunder, 2, 10 og 30 minutter. Et 410 Gone stopper nye forsøk.

Slik kobler du til Webhooks

  1. Åpne Alert channels i sidemenyen og velg Add channel.

  2. Velg Webhook og skriv inn Endpoint URL.

  3. Velg Add channel og kopier signeringsnøkkelen som vises. Den vises bare én gang.

  4. Velg Send test for å sende en testhendelse til endepunktet ditt.

Alle felt og en Python-versjon av sjekken finnes i API-referansen.

Inkludert i alle planer, også Free-planen.

Hva som kommer frem

monitor.down
Et bekreftet driftsavbrudd
monitor.up
Gjenopprettingen, med nedetiden
monitor.slow
Svar over grensen din
monitor.fast
Under grensen igjen
certificate.expiring
Et TLS-sertifikat utløper snart eller har utløpt
domain.expiring
En domeneregistrering utløper snart eller har utløpt
dns.changed
Endrede DNS-poster, med før og etter
server.rebooted
En server med agenten startet på nytt
site.issues
Nye brutte lenker eller blandet innhold
site.performance_dropped
En sides mobilhastighetspoeng falt under grensen din
domain.email_issues
Nye problemer med e-postoppsettet til et domene
test
Sendt med Send test

POST til endepunktet ditt

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-hendelse. monitor.up har samme hendelses-ID og nedetiden i sekunder.

Spørsmål

Hvordan verifiserer jeg signaturen?

Beregn HMAC-SHA256 over verdien i x-uptimecheck-timestamp, et punktum og den rå forespørselskroppen, med signeringsnøkkelen som nøkkel. Sammenlign den i konstant tid med hex-verdien etter sha256= i x-uptimecheck-signature, og avvis gamle tidsstempler.

Hvilke hendelser 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.

Hva skjer når endepunktet mitt er nede?

En forespørsel som ikke får et 2xx-svar innen 10 sekunder, prøves på nytt fire ganger til, etter 30 sekunder, 2 minutter, 10 minutter og 30 minutter. Deretter viser kanalen Not delivering med den siste feilen. Svarer du 410 Gone, stopper nye forsøk med en gang.

Kan jeg se signeringsnøkkelen igjen?

Nei. Den vises én gang, når du legger til kanalen, og den endres aldri. For en ny hemmelighet legger du til en ny webhook-kanal og sletter den gamle.

Kan abonnentene på statussiden vår følge det her også?

Ja. Besøkende på en statusside fra Uptimecheck kan følge den i Slack, Microsoft Teams, Discord eller via webhook, for hele siden eller bare komponentene de velger, og få statusoppdateringene dine der.

Er det inkludert i alle planer?

Ja. Alle varslingskanaler unntatt SMS finnes på alle planer, også Free; SMS krever en betalt plan og bruker kreditter (inkludert på Professional og Business, kjøpte pakker på Start). Planene skiller seg i hvor mange varslingskanaler du kan legge til: 3 på Free, 25 på Start, 75 på Professional og 250 på Business.

Nedetid er fortid.

Sett opp din første monitor på under ett minutt, eller se deg rundt i livedemoen først.

14 dagers gratis prøveperiode · Deretter gratis for 5 monitorer · Uten kredittkort