API und Schnittstelle
Zuletzt aktualisiert:
Wozu
fwMAX.de hat eine offene REST-API unter https://api.fwmax.de/v1. Damit holt ihr Daten in eigene Systeme oder schickt Einsätze aus Alamos FE2 und der Leitstelle direkt hinein. Die vollständige Beschreibung steht unter Schnittstelle.
Schritt für Schritt
- Schlüssel anlegen. Verwaltung › Schnittstelle: API-Schlüssel anlegen. Er wird nur einmal angezeigt; sperren und löschen geht jederzeit.
- Anfragen senden. Header
Authorization: Bearer fwmax_…, z. B.GET /v1/personen?suche=oderGET /v1/fristen?tage=60. - Einsätze empfangen. FE2 sendet an
POST /v1/einsaetze/fe2; andere Systeme anPOST /v1/einsaetze.
So läuft es ab
Kurz erklärt: Leitstelle, Alamos FE2 und eigene Systeme sprechen mit api.fwmax.de. Der API-Schlüssel bestimmt die Feuerwehr und die Rechte. Fehlt ein gültiger Schlüssel oder das Recht, antwortet die API mit 401 oder 403, sonst mit JSON. Über Webhooks meldet fwMAX.de Ereignisse zurück.
Rollen und Rechte
- API-Schlüssel verwalten: Recht „API-Schnittstelle“.
- Einsätze anlegen per API: „Einsätze bearbeiten“.
Tipps
- Zum Ausprobieren gibt es einen Demo-Schlüssel, siehe Schnittstelle.
- Gebt jedem System einen eigenen Schlüssel, dann könnt ihr ihn einzeln sperren.
Häufige Fragen
Gibt es Kosten für die API?
Nein, die Schnittstelle ist im Preis enthalten.
Wo finde ich die Endpunkte?
Auf der Seite Schnittstelle und in der interaktiven Beschreibung unter api.fwmax.de.
Verwandte Themen
- Einsätze, Einsatzbericht und EinsatzleitungAlarm aus FE2, Einsatzbericht, Einsatzleitung, Atemschutz.
- KI und MCP: fwMAX.de mit KI-Apps verbindenClaude, ChatGPT und Co. sicher per OAuth und MCP anbinden.
- Konto, Benutzer und SicherheitZwei-Faktor-Anmeldung, Rechte, Bestellung, Protokoll.
Fehlt etwas? Im Programm oben rechts „Problem melden oder Verbesserung vorschlagen“, oder per E-Mail an support@fwmax.de.