Schnittstelle "Webhook"

Über die Schnittstelle „Webhook“ übergeben Drittsysteme per standardisiertem HTTP-GET-Aufruf Informationen an EDP. Diese Seite beschreibt die Konfiguration und alle unterstützten Aufrufe.

✔ = Die Schnittstelle unterstützt diese Funktion. ✘ = Die Schnittstelle unterstützt diese Funktion nicht. (Leer) = Entfällt.

Die Schnittstelle Webhook stellt einen eigenen Webserver bereit. Dessen Port geben Sie im Konfigurationsdialog an. Zusätzlich können Sie den Pfad zu einem SSL-Zertifikat und der zugehörigen Key-Datei angeben. Bleiben diese Felder leer, läuft der Webserver ohne SSL-Verschlüsselung.

Außerdem lässt sich ein Token definieren, das in jedem HTTP-GET-Aufruf enthalten sein muss. Ist ein Token definiert, verarbeitet die Schnittstelle nur Aufrufe, die dieses Token mitliefern.

Über die Webhook-Schnittstelle können Einsatzdaten sowie Status- und Positionsmeldungen von Einsatzmitteln per HTTP-GET-Aufruf an EDP übergeben werden. Folgende Aufrufe werden unterstützt.

Über den Endpoint neweinsatz übergeben Sie Einsatzdaten als URL-Parameter an EDP:

https://{IP}:{PORT}/{TOKEN}/neweinsatz?einsatznummer=...&ort=...&ortsteil=..&einsatzart=F&stichwort=1&einsatzmittel=Rufname1,Rufname2&strasse=Hauptstra%C3%9Fe&hausnummer=11...

Die Einsatznummer (EDP schreibt sie in das DB-Feld INTERNE_NUMMER) und EXTERNAL_ID dienen zur Identifikation des Einsatzes. Wird ein Einsatz mehrfach mit der gleichen Nummer bzw. ID übertragen, aktualisiert EDP den bestehenden Einsatz.

Folgende Felder können übergeben werden:

• INTERNE_NUMMER
• EXTERNAL_ID
• ORT
• ORTSTEIL
• STRASSE
• HAUSNUMMER
• OBJEKTNAME
• EINSATZART
• STICHWORT
• STICHWORT_KLARTEXT
• MELDUNG
• SCHLAGWORT (als Parameter meldebild)
• MELDENDER
• MELDEWEG_TELEFON (als Parameter telefon)
• BEMERKUNG
• KOORDX
• KOORDY
• EINSATZMITTEL (Rufnamen der beteiligten Einsatzmittel, durch Komma getrennt)

Ergänzen Sie in der Konfigurationsdatei folgenden Eintrag, können sämtliche Felder der Tabelle EINSAETZE beschrieben werden. Die Konfigurationsdatei öffnen Sie in edp:konfig per Rechtsklick auf die Schnittstelle → „Grunddaten“ → „Konfig Datei anzeigen“.

[Webhook]
...
DirectParamMappingNewEinsatz=1

Mit folgendem Aufruf übergeben Sie die Status-Meldung eines Einsatzmittels an EDP:

https://{IP}:{PORT}/{TOKEN}/setstatus?issi={ISSI}&status={STATUS}

Beispiel:

https://localhost:454/123/setstatus?issi=1234567&status=4

Übermittelt wird nicht der Rufname, sondern die ISSI des Einsatzmittels. Diese ISSI muss im Einsatzmittel unter „Tetrageräte“ hinterlegt sein. Dort muss außerdem der Haken gesetzt sein, dass Status-Meldungen dieses Geräts ausgewertet werden.

Mit folgendem Aufruf übergeben Sie eine Positionsmeldung an EDP:

https://IP:Port/{TOKEN}/gpsposition?issi={ISSI}&lat={lat}&lon={lon}

Beispiel:

https://localhost:454/123/gpsposition?issi=1234567&lat=49,5&lon=8,2

Auch hier wird nicht der Rufname des Einsatzmittels übergeben, sondern die ISSI eines Funkgeräts. Sie muss beim betreffenden Einsatzmittel unter „Tetrageräte“ hinterlegt sein, und dort muss ebenfalls der Haken „Status-Meldungen auswerten“ gesetzt sein.

Im Rahmen der Weiterentwicklung kommen zusätzliche Endpoints hinzu, die hier bereits dokumentiert sind.

Mit folgendem Aufruf übergeben Sie eine SDS-Textnachricht an EDP:

 https://{IP}:{PORT}/{TOKEN}/incommingsds?issi={ISSI}&text={NACHRICHT} 

Beispiel:

 https://localhost:454/123/incommingsds?issi=1234567&text=Testnachricht 

Die ISSI muss im Einsatzmittel unter „Tetrageräte“ hinterlegt sein.

Mit folgendem Aufruf übergeben Sie eine PTT-Meldung (Push-To-Talk) an EDP:

 https://{IP}:{PORT}/{TOKEN}/incommingptt?issi={ISSI} 

Beispiel:

 https://localhost:454/123/incommingptt?issi=1234567 

Mit folgendem Aufruf ordnen Sie ein Einsatzmittel einem Einsatz zu:

 https://{IP}:{PORT}/{TOKEN}/dispoem?rufname={RUFNAME}&einsatznummer={EINSATZNUMMER} 

Beispiel:

 https://localhost:454/123/dispoem?rufname=Florian1&einsatznummer=12345 

Mit folgendem Aufruf übergeben Sie einen BMA-Alarm (Brandmeldeanlage) an EDP:

 https://{IP}:{PORT}/{TOKEN}/incommingbma?ALARMID={ALARMID}&UUID_DATENPUNKT=...&KATEGORIE=...&... 

Die Parameter richten sich nach der Konfiguration und können Platzhalter enthalten, die durch die Werte ersetzt werden.

Mit folgendem Aufruf fragen Sie die Einsatznummer zu einer BMA-AlarmID ab:

 https://{IP}:{PORT}/{TOKEN}/getbmaenr?alarmid={ALARMID} 

Als Antwort liefert die Schnittstelle die zugehörige Einsatznummer als Text.

Mit folgendem Aufruf übergeben Sie eine Rückmeldung zu einem Einsatz:

 https://{IP}:{PORT}/{TOKEN}/newrueckmeldung?einsatznummer={EINSATZNUMMER}&meldender={NAME}&meldeweg={WEG}&eintrag={TEXT} 

Statt einsatznummer kann auch external_id verwendet werden.

Mit folgendem Aufruf übergeben oder aktualisieren Sie Patientendaten zu einem Einsatz:

 https://{IP}:{PORT}/{TOKEN}/newpatient?einsatznummer={EINSATZNUMMER}&id={PATIENT_ID}&vorname=...&nachname=...&uhs_patnummer=... 

Wird eine id übergeben, aktualisiert EDP den vorhandenen Patienten, andernfalls wird ein neuer angelegt. Statt einsatznummer kann auch external_id verwendet werden. Übergeben werden können alle Felder der Tabelle PATIENTEN. Die Rückgabe erfolgt als JSON mit Status und Patientendaten.