Een webhookkanaal stuurt met een POST JSON naar een URL die je zelf kiest als een monitor uitvalt of herstelt, en bij andere alerts zoals trage responses, verlopende certificaten en gewijzigde DNS-records. Elk request is ondertekend, zodat je endpoint kan controleren dat het echt van Uptimecheck komt.
De webhook toevoegen
Open Alert channels in de zijbalk en kies Add channel.Selecteer Webhook en vul de Endpoint URL in.Kies Add channel en kopieer het signing secret dat verschijnt. Het wordt maar één keer getoond.Kies Send test om een testaanroep te sturen.
De handtekening verifiëren
Elk request bevat twee headers:
x-uptimecheck-timestamp: Unix-tijd in seconden waarop het request is ondertekend.x-uptimecheck-signature: sha256= gevolgd door de hexadecimale HMAC-SHA256 van de timestamp, een punt en de ruwe body, met het signing secret van het kanaal als sleutel.
Bereken dezelfde waarde uit de ruwe body voordat je die parset, vergelijk in constante tijd en weiger oude timestamps. In Node.js:
import { createHmac, timingSafeEqual } from “node:crypto”;
export function isFromUptimecheck(rawBody, headers, secret) {
const timestamp = headers[“x-uptimecheck-timestamp”] ?? “”;
const signature = headers[“x-uptimecheck-signature”] ?? “”;
const expected = “sha256=” + createHmac(“sha256”, secret).update(`${timestamp}.${rawBody}`).digest(“hex”);
const fresh = Math.abs(Date.now() / 1000 – Number(timestamp)) < 300;
return fresh && signature.length === expected.length && timingSafeEqual(Buffer.from(signature), Buffer.from(expected));
}
Een Python-versie en alle velden van de payload staan in de API-documentatie.
Goed om te weten
Antwoord binnen 10 seconden met een willekeurige 2xx-status. Bij elk ander antwoord proberen we het nog vier keer, na 30 s, 2 min, 10 min en 30 min.Het veld event zegt wat er is gebeurd, zoals monitor.down, monitor.up, monitor.slow, certificate.expiring of dns.changed. De API-referentie noemt elk event en laat zien hoe je de handtekening verifieert.Gebruik HTTPS, en doe traag werk pas nadat je hebt geantwoord.
Bekijk alle alertkanalen, of automatiseer de configuratie met de REST API.