Integraatio · Kehittäjille

Hälytykset allekirjoitettuina webhookit

Jokainen hälytys JSONina omaan päätepisteeseesi, allekirjoitettuna HMAC-SHA256:lla, jotta voit todistaa sen tulleen Uptimecheckistä.

14 päivän ilmainen kokeilu · Sen jälkeen ilmainen 5 valvonnalle · Ei luottokorttia

Mitä saat

  • Allekirjoitetut pyynnöt

    Jokainen POST sisältää otsakkeet x-uptimecheck-timestamp ja x-uptimecheck-signature: aikaleiman ja rungon HMAC-SHA256, avaimena kanavan allekirjoitusavain.

  • Selkeät tapahtumien nimet

    monitor.down, monitor.up, monitor.slow, certificate.expiring, dns.changed ja muita, joten koodisi haarautuu yhden kentän perusteella.

  • Yksi häiriö, molemmat päät

    monitor.down ja monitor.up kantavat samaa häiriötunnusta, joten voit avata ja sulkea vastaavan tietueen omassa järjestelmässäsi.

  • Uudelleenyritykset sisäänrakennettuina

    Jos vastaus ei ole 2xx 10 sekunnin sisällä, lähetys yritetään uudelleen 30 sekunnin, 2, 10 ja 30 minuutin kuluttua. 410 Gone lopettaa uudelleenyritykset.

Näin yhdistät palvelun Webhookit

  1. Avaa sivupalkista Alert channels ja valitse Add channel.

  2. Valitse Webhook ja syötä Endpoint URL.

  3. Valitse Add channel ja kopioi näkyviin tuleva allekirjoitusavain. Se näytetään vain kerran.

  4. Valitse Send test lähettääksesi testitapahtuman päätepisteeseesi.

Jokainen kenttä ja tarkistuksen Python-versio löytyvät API-dokumentaatiosta.

Sisältyy kaikkiin paketteihin, myös Free-pakettiin.

Mitä saapuu

monitor.down
Vahvistettu katko
monitor.up
Palautuminen katkon kestoineen
monitor.slow
Rajasi ylittävät vastaukset
monitor.fast
Taas rajan alla
certificate.expiring
TLS-varmenne vanhenee pian tai on vanhentunut
domain.expiring
Verkkotunnuksen rekisteröinti vanhenee pian tai on vanhentunut
dns.changed
Muuttuneet DNS-tietueet, ennen ja jälkeen
server.rebooted
Palvelin, jossa agentti on, käynnistyi uudelleen
site.issues
Uudet rikkinäiset linkit tai sekasisältö
site.performance_dropped
Sivun mobiilinopeuden pisteet laskivat alle asettamasi rajan
domain.email_issues
Uudet ongelmat verkkotunnuksen sähköpostiasetuksissa
test
Lähetetty Send test -toiminnolla

POST omaan päätepisteeseesi

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
}
monitor.down-tapahtuma. monitor.up sisältää saman häiriötunnuksen ja katkon keston sekunteina.

Kysymykset

Miten tarkistan allekirjoituksen?

Laske HMAC-SHA256 x-uptimecheck-timestamp-arvosta, pisteestä ja pyynnön raa’asta rungosta allekirjoitusavaimella. Vertaa sitä vakioajassa x-uptimecheck-signature-otsakkeen sha256=-osan jälkeiseen heksa-arvoon ja hylkää vanhat aikaleimat.

Mitä tapahtumia lähetetään?

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

Mitä tapahtuu, kun päätepisteeni on alhaalla?

Pyyntöä, joka ei saa 2xx-vastausta 10 sekunnin kuluessa, yritetään uudelleen vielä neljä kertaa: 30 sekunnin, 2 minuutin, 10 minuutin ja 30 minuutin kuluttua. Sen jälkeen kanavalla näkyy Not delivering ja viimeisin virhe. Vastaus 410 Gone lopettaa uudelleenyritykset heti.

Näenkö allekirjoitusavaimen uudelleen?

Ei. Se näytetään kerran, kun lisäät kanavan, eikä se koskaan muutu. Jos tarvitset uuden salaisuuden, lisää uusi webhook-kanava ja poista vanha.

Voivatko tilasivumme tilaajat seurata sitä myös täällä?

Kyllä. Uptimecheckin tilasivun kävijät voivat seurata sitä Slackissa, Microsoft Teamsissa, Discordissa tai webhookilla, koko sivua tai vain valitsemiaan komponentteja, ja saada tilapäivityksesi sinne.

Sisältyykö se kaikkiin paketteihin?

Kyllä. Kaikki hälytyskanavat paitsi SMS ovat käytössä jokaisessa paketissa, myös Free-paketissa. SMS vaatii maksullisen paketin ja käyttää krediittejä (sisältyvät Professional- ja Business-paketteihin, Start-paketissa ostettavina paketteina). Paketit eroavat siinä, kuinka monta hälytyskanavaa voit lisätä: Free 3, Start 25, Professional 75 ja Business 250.

Katkot ovat menneisyyttä.

Luo ensimmäinen valvontasi alle minuutissa – tai tutustu ensin live-demoon.

14 päivän ilmainen kokeilu · Sen jälkeen ilmainen 5 valvonnalle · Ei luottokorttia