Kostenlos testen

Integration · Entwickler

Alarme als signierte Webhooks

Jeder Alarm als JSON an Ihren eigenen Endpunkt, signiert mit HMAC-SHA256, damit Sie nachweisen können, dass er von Uptimecheck stammt.

Kostenlos testen Live-Demo ausprobieren

14 Tage kostenlos testen · Danach gratis für 5 Monitore · Keine Kreditkarte

Was Sie bekommen

  • Signierte Anfragen

    Jeder POST enthält x-uptimecheck-timestamp und x-uptimecheck-signature: einen HMAC-SHA256 aus Zeitstempel und Body, mit dem Signing Secret des Kanals als Schlüssel.

  • Eindeutige Event-Namen

    monitor.down, monitor.up, monitor.slow, certificate.expiring, dns.changed und mehr, sodass Ihr Code anhand eines einzigen Felds entscheidet.

  • Ein Vorfall, beide Seiten

    monitor.down und monitor.up tragen dieselbe Incident-ID, sodass Sie den passenden Datensatz auf Ihrer Seite öffnen und schließen können.

  • Integrierte Wiederholungen

    Alles außer einer 2xx-Antwort innerhalb von 10 Sekunden wird nach 30 Sekunden, 2, 10 und 30 Minuten erneut versucht. Ein 410 Gone beendet die Wiederholungen.

So verbinden Sie Webhooks

  1. Öffnen Sie in der Seitenleiste Alert channels und wählen Sie Add channel.

  2. Wählen Sie Webhook und geben Sie die Endpoint URL ein.

  3. Wählen Sie Add channel und kopieren Sie das angezeigte Signing Secret. Es wird nur einmal angezeigt.

  4. Wählen Sie Send test, um ein Test-Event an Ihren Endpunkt zu senden.

Alle Felder und eine Python-Version der Prüfung finden Sie in der API-Referenz.

In jedem Tarif enthalten, auch im Free-Tarif.

Einrichten Webhook-Alarme einrichten und verifizieren

Was ankommt

monitor.down
Ein bestätigter Ausfall
monitor.up
Die Wiederherstellung, mit der Ausfallzeit
monitor.slow
Antworten über Ihrem Grenzwert
monitor.fast
Wieder unter dem Limit
certificate.expiring
Ein TLS-Zertifikat läuft bald ab oder ist abgelaufen
domain.expiring
Eine Domainregistrierung läuft bald ab oder ist abgelaufen
dns.changed
Geänderte DNS-Einträge, mit Vorher und Nachher
server.rebooted
Ein Server mit dem Agent wurde neu gestartet
site.issues
Neue defekte Links oder Mixed Content
site.performance_dropped
Der mobile Speed-Score einer Seite ist unter Ihren Grenzwert gefallen
domain.email_issues
Neue Probleme bei der E-Mail-Konfiguration einer Domain
test
Gesendet über „Send test“

POST an Ihren Endpunkt

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
}
Ein monitor.down-Event. monitor.up trägt dieselbe Incident-ID und die Ausfallzeit in Sekunden.

Fragen

Wie prüfe ich die Signatur?

Berechnen Sie HMAC-SHA256 über den Wert von x-uptimecheck-timestamp, einen Punkt und den unveränderten Request-Body, mit dem Signing Secret als Schlüssel. Vergleichen Sie das Ergebnis in konstanter Zeit mit dem Hex-Wert nach sha256= in x-uptimecheck-signature und lehnen Sie alte Zeitstempel ab.

Welche Events werden gesendet?

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

Was passiert, wenn mein Endpunkt nicht erreichbar ist?

Eine Anfrage, die nicht innerhalb von 10 Sekunden eine 2xx-Antwort erhält, wird viermal erneut versucht, nach 30 Sekunden, 2 Minuten, 10 Minuten und 30 Minuten. Danach zeigt der Kanal „Not delivering“ mit dem letzten Fehler an. Eine Antwort mit 410 Gone stoppt die Wiederholungen sofort.

Kann ich das Signing Secret noch einmal sehen?

Nein. Es wird einmal angezeigt, wenn Sie den Kanal hinzufügen, und ändert sich nie. Für ein neues Secret fügen Sie einen neuen Webhook-Kanal hinzu und löschen den alten.

Können unsere Statusseiten-Abonnenten das auch hier verfolgen?

Ja. Besucher einer Uptimecheck-Statusseite können ihr in Slack, Microsoft Teams, Discord oder per Webhook folgen, für die ganze Seite oder nur für ausgewählte Komponenten, und erhalten Ihre Status-Updates dort.

Ist es in jedem Tarif enthalten?

Ja. Jeder Alarmkanal außer SMS ist in jedem Tarif enthalten, auch im Free-Tarif; SMS erfordert einen kostenpflichtigen Tarif und verbraucht Guthaben (inklusive bei Professional und Business, als gekaufte Pakete bei Start). Die Tarife unterscheiden sich darin, wie viele Alarmkanäle Sie anlegen können: 3 bei Free, 25 bei Start, 75 bei Professional und 250 bei Business.

Passt gut zu

Alle Integrationen

Downtime ist von gestern.

Richten Sie Ihren ersten Monitor in weniger als einer Minute ein – oder sehen Sie sich zuerst die Live-Demo an.

Kostenlos testen Tarife vergleichen

14 Tage kostenlos testen · Danach gratis für 5 Monitore · Keine Kreditkarte