Über die Schnittstelle (API) lesen und schreiben andere Systeme die Daten eurer Feuerwehr, zum Beispiel die Webseite, die Alarmierung oder die Lohnabrechnung. Jedes System bekommt einen eigenen API-Key mit genau den Rechten, die es braucht.
- Adresse
https://api.fwmax.de/v1- Ausprobieren
- Alle Adressen mit Beispielen, direkt im Browser (mit dem API-Key
demogegen die Live-Demo) - Anleitung
- Beschreibung mit Beispielen
- Für Programme
- OpenAPI-Beschreibung
Noch kein API-Key. Lege mit „Neuer API-Key“ den ersten an.
Einsatz-Widget für die Homepage
Die letzten Einsätze auf eurer Homepage, ohne Namen: als fertige Liste zum Einbetten (iframe) oder als JSON für eigene Skripte. Was zu sehen ist, stellt ihr je Widget ein. Die Liste wird fünf Minuten zwischengespeichert.
Alarm aus Alamos FE2 übernehmen
FE2 legt mit jedem Alarm den Einsatz in Feuerwehr MAX an. Dieselbe Einsatznummer der Leitstelle legt im selben Jahr keinen zweiten Einsatz an, auch wenn FE2 den Alarm mehrfach sendet.
- Oben einen API-Key mit dem Recht „Einsätze bearbeiten“ anlegen, z. B. „Alamos FE2“, für die Einheit, die ausrückt.
- In FE2 einen Ausgang „HTTP“ (bzw. „Externe Schnittstelle / JSON“) anlegen: Methode
POST, Format JSON. - Als Adresse
https://api.fwmax.de/v1/einsaetze/fe2eintragen, optional mit?einsatzeinheit=NUMMERfür die Einheit. - Kopfzeile
Authorization: Bearer fwmax_...mit dem API-Key setzen. - Mit einem Probealarm prüfen: der Einsatz erscheint unter Einsätze; im Protokoll der Ereignisse steht
einsatz.angelegt.
Beispiel:
curl -X POST -H "Authorization: Bearer fwmax_..." -H "Content-Type: application/json" \
-d '{"data":{"keyword":"B3","keyword_description":"Wohnungsbrand","einsatznummer":"LST-2026-004711","street":"Hauptstraße","house":"12","city":"Musterstadt","vehicles":["Florian Musterstadt 1/44-1"]}}' \
https://api.fwmax.de/v1/einsaetze/fe2