Ein Webhook ist eine Adresse eures Systems, die Feuerwehr MAX aufruft, sobald etwas passiert: ein Alarm, eine Rückmeldung, ein abgeschlossener Einsatzbericht. So erfahren die Anzeige an der Wache, die Webseite oder die Haussteuerung davon, ohne ständig nachzufragen.
Die Live-Demo ist nur zum Ansehen: Hier lässt sich kein Webhook anlegen und es wird nichts versendet.
Noch kein Webhook. Lege mit „Neuer Webhook“ den ersten an.
So sieht ein Aufruf aus
Feuerwehr MAX schickt ein POST mit diesem Inhalt (ein CloudEvent, Fassung 1.0). Was unter data steht, hängt von der Art des Ereignisses ab.
{
"specversion": "1.0",
"id": "3f2b8c1e-5d47-4a90-b1c6-7e0a9d2f4b13",
"source": "https://demo.fwmax.de",
"type": "de.fwmax.alarm.ausgeloest",
"subject": "alarm/4711",
"time": "2026-11-17T07:46:17.906Z",
"datacontenttype": "application/json",
"data": {
"id": 4711,
"stichwort": "B3 Wohnungsbrand",
"text": "Rauch aus Fenster im 2. OG",
"ort": "Hauptstraße 12",
"zeitpunkt": "2026-11-17T07:46:17.9069148+00:00",
"istProbe": false,
"einheiten": [
3
]
}
}
- Kopfzeilen
X-Fwmax-Signatur: t=ZEIT,v1=SIGNATUR(Zeit in Sekunden seit 1970, Signatur mit 64 Zeichen),X-Fwmax-Ereignis: alarm.ausgeloest,X-Fwmax-Kennungmit deriddes Ereignisses,User-Agent: fwMAX.de-Webhook/1- Signatur prüfen
- Rechnet HMAC-SHA256 über
t + "." + Inhaltmit eurem Geheimnis als Schlüssel und vergleicht das Ergebnis (hexadezimal) mitv1. Lehnt Aufrufe ab, derentälter als fünf Minuten ist. - Antwort
- Antwortet innerhalb von 10 Sekunden mit einem Status 2xx. Alles andere gilt als nicht zugestellt.
- Wiederholung
- Nach 1 Minute, 5 Minuten, 30 Minuten, 2 Stunden, 6 Stunden und 24 Stunden. Danach gilt die Zustellung als gescheitert und lässt sich im Protokoll von Hand erneut senden. Nach 20 Fehlern in Folge wird der Webhook abgeschaltet und die Verwalter bekommen eine E-Mail.
- Doppelte
- Ein Ereignis kann in seltenen Fällen zweimal ankommen.
idist für immer eindeutig: Was ihr schon kennt, könnt ihr übergehen.
// Beispiel in JavaScript (Node.js)
const crypto = require('crypto');
function echt(geheimnis, kopf, inhalt) { // kopf = Kopfzeile X-Fwmax-Signatur, inhalt = roher Text des Aufrufs
const teile = Object.fromEntries(kopf.split(',').map(t => t.split('=')));
if (Math.abs(Date.now() / 1000 - Number(teile.t)) > 300) return false;
const erwartet = crypto.createHmac('sha256', geheimnis).update(teile.t + '.' + inhalt).digest('hex');
return erwartet.length === teile.v1.length && crypto.timingSafeEqual(Buffer.from(erwartet), Buffer.from(teile.v1));
}