Feuerwehr MAX Demo-Feuerwehr MusterstadtLive-Demo, nur zum Ansehen 30 Tage kostenlos testen
Live
Webhooks 0 von 10 aktiv 0 Health-Check Schnittstelle

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-Kennung mit der id des Ereignisses, User-Agent: fwMAX.de-Webhook/1
Signatur prüfen
Rechnet HMAC-SHA256 über t + "." + Inhalt mit eurem Geheimnis als Schlüssel und vergleicht das Ergebnis (hexadezimal) mit v1. Lehnt Aufrufe ab, deren t ä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. id ist 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));
}
Es ist ein Fehler aufgetreten. Neu laden

Rejoining the server...

Rejoin failed... trying again in seconds.

Failed to rejoin.
Please retry or reload the page.

The session has been paused by the server.

Failed to resume the session.
Please retry or reload the page.