Start gratis proefperiode

Integratie · Developers

Meldingen als ondertekende webhooks

Elke melding als JSON naar je eigen endpoint, ondertekend met HMAC-SHA256 zodat je kunt aantonen dat hij van Uptimecheck komt.

Start gratis proefperiode Probeer de live demo

14 dagen gratis proberen · Daarna gratis met 5 monitors · Geen creditcard

Wat je krijgt

  • Ondertekende verzoeken

    Elke POST bevat x-uptimecheck-timestamp en x-uptimecheck-signature: een HMAC-SHA256 van de timestamp en de body, met het signing secret van het kanaal als sleutel.

  • Duidelijke eventnamen

    monitor.down, monitor.up, monitor.slow, certificate.expiring, dns.changed en meer, zodat je code op één veld kan schakelen.

  • Eén incident, beide kanten

    monitor.down en monitor.up dragen hetzelfde incident-ID, zodat je het bijbehorende record aan jouw kant kunt openen en sluiten.

  • Ingebouwde retries

    Alles behalve een 2xx-antwoord binnen 10 seconden wordt opnieuw geprobeerd na 30 seconden, 2, 10 en 30 minuten. Een 410 Gone stopt de nieuwe pogingen.

Webhooks koppelen

  1. Open Alert channels in de zijbalk en kies Add channel.

  2. Kies Webhook en vul de Endpoint URL in.

  3. Kies Add channel en kopieer het signing secret dat verschijnt. Het wordt maar één keer getoond.

  4. Kies Send test om een testevent naar je endpoint te sturen.

Elk veld en een Python-versie van de controle staan in de API-referentie.

Inbegrepen in elk abonnement, ook in het Free-abonnement.

Instellen Webhook-alerts instellen en verifiëren

Wat er binnenkomt

monitor.down
Een bevestigde storing
monitor.up
Het herstel, met de downtime
monitor.slow
Responses boven je limiet
monitor.fast
Weer onder de limiet
certificate.expiring
Een TLS-certificaat verloopt binnenkort of is verlopen
domain.expiring
Een domeinregistratie verloopt binnenkort of is verlopen
dns.changed
Gewijzigde DNS-records, met voor en na
server.rebooted
Een server met de agent is herstart
site.issues
Nieuwe kapotte links of mixed content
site.performance_dropped
De mobiele snelheidsscore van een pagina zakte onder je grens
domain.email_issues
Nieuwe problemen met de e-mailinstellingen van een domein
test
Verstuurd via Test versturen

POST naar je 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
}
Een monitor.down-event. monitor.up bevat hetzelfde incident-ID en de downtime in seconden.

Vragen

Hoe verifieer ik de handtekening?

Bereken HMAC-SHA256 over de waarde van x-uptimecheck-timestamp, een punt en de ruwe request body, met het signing secret als sleutel. Vergelijk dat in constante tijd met de hexwaarde na sha256= in x-uptimecheck-signature, en weiger oude timestamps.

Welke events worden verstuurd?

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

Wat gebeurt er als mijn endpoint down is?

Een verzoek dat binnen 10 seconden geen 2xx-antwoord krijgt, wordt nog vier keer opnieuw geprobeerd, na 30 seconden, 2 minuten, 10 minuten en 30 minuten. Daarna toont het kanaal Niet bezorgd met de laatste fout. Antwoorden met 410 Gone stopt de nieuwe pogingen meteen.

Kan ik het signing secret opnieuw zien?

Nee. Het wordt één keer getoond, als je het kanaal toevoegt, en verandert nooit. Wil je een nieuw secret, voeg dan een nieuw webhookkanaal toe en verwijder het oude.

Kunnen abonnees van onze statuspagina het hier ook volgen?

Ja. Bezoekers van een Uptimecheck-statuspagina kunnen die volgen in Slack, Microsoft Teams, Discord of via webhook, voor de hele pagina of alleen de onderdelen die ze kiezen, en ontvangen daar je statusupdates.

Zit het in elk abonnement?

Ja. Elk alertkanaal behalve sms zit in elk abonnement, ook in het Free-abonnement; sms vereist een betaald abonnement en werkt met tegoed (inbegrepen bij Professional en Business, bij Start via gekochte bundels). Abonnementen verschillen in hoeveel alertkanalen je kunt toevoegen: 3 bij Free, 25 bij Start, 75 bij Professional en 250 bij Business.

Werkt goed met

Alle integraties

Downtime is verleden tijd.

Stel je eerste monitor in binnen een minuut, of kijk eerst rond in de live demo.

Start gratis proefperiode Vergelijk abonnementen

14 dagen gratis proberen · Daarna gratis met 5 monitors · Geen creditcard