Neben den Schnittstellen wie dem Alarmserver zur E-Mail-Auswertung oder SMS-Inbound, gibt es auch die Möglichkeit eine Alarmierung über unsere Web-Schnittstelle auszulösen.
Die URL für die Schnittstelle lautet: https://www.divera247.com/api/alarm?accesskey=ALARM_ACCESSKEY
Den Access-Key findet Sie als Administrator im Menü unter Verwaltung > Einstellungen > Schnittstellen > Alarmierung.
Hinweis für Nutzer der kostenlosen Version: In DIVERA 24/7 FREE wird ausschließlich das Einsatzstichwort ausgewertet und gespeichert. Ab der ALARM-Version können alle Einsatz-Daten übernommen werden.
Folgende optionale Parameter können via GET oder POST verwendet werden:
Parameter (häufig genutzt) | Bedeutung | Datentyp | Bemerkung |
---|---|---|---|
number | Einsatznummer | Integer | Eigene Nummer des Einsatzes, z.B. laufende Einsatznummer der Leitstelle. |
title | Einsatzstichwort | String | Auf 50 Zeichen begrenzt (bei FREE 30 Zeichen). Wird in der Push Nachricht angezeigt. |
priority | Priorität/Sonderrechte | Boolean/Integer | true oder 1, um Feld zu aktivieren |
text | Meldungstext | String | Längerer Text mit Detailinformationen. Länge max. 1000 Zeichen |
address | Adresse | String | Maximal 200 Zeichen ab ALARM Version |
lng | Breitengrad | Float | Komma durch Punkt ersetzen |
lat | Längengrad | Float | Komma durch Punkt ersetzen |
ric | Alarmierte Gruppe(n) oder Untereinheit(en) | String | Alarmierungs-RIC, mehrere Werte kommasepariert angeben |
vehicle | Alarmierte Fahrzeug(e) | String | Alarmierungs-RIC, mehrere Werte kommasepariert angeben |
person | Alarmierte Person(en) | String | Fremdschlüssel, mehrere Werte kommasepariert angeben |
Parameter (erweitert) | Bedeutung | Datentyp | Bemerkung |
delay | Sekunden die seit dem Alarm vergangen sind | Integer | Korrigiert die Uhr im Alarmmonitor |
coordinates | Aktiviert ein abweichendes Koordinatensystem | String | Erlaubte Werte: gk |
coordinates-x | X-Wert einer Koordinate im Gauß-Krüger Format | Float | Nur erlaubt, wenn coordinates den Wert gk hat |
coordinates-y | Y-Wert einer Koordinate im Gauß-Krüger Format | Float | Nur erlaubt, wenn coordinates den Wert gk hat |
news | Mitteilung statt einer Alarmierung erstellen | Boolean/Integer | true oder 1 senden, um eine normale Mitteilung mit leiser Benachrichtigung zu erzeugen. Alternativ die URL https://www.divera247.com/api/news?accesskey=API_KEY mit selben Parametern nutzen, es entfallen jedoch Priorität, Koordinaten und Fahrzeuge. |
Parameter (fortgeschritten) | Bedeutung | Datentyp | Bemerkung |
id | Primärschlüssel einer bestehenden Alarmierung | Integer | Dient dem dem Aktualisieren einer bestehenden Meldung, kann über /last-alarm ausgelesen werden |
cluster_ids | Primärschlüssel von Untereinheiten | Integer-Array | |
group_ids | Primärschlüssel von Gruppen | Integer-Array | |
user_cluster_relation_ids | Primärschlüssel von Benutzern | Integer-Array | |
vehicle_ids | Primärschlüssel von Einsatzfahrzeugen | Integer-Array | |
alarmcode_id | Primärschlüssel einer Alarmvorlage | Integer |
Hinweise zur Übertragung der Adresse
Angabe von Empfängern/gezielte Alarmierung
Wichtige Hinweise
Auswertung von Alarmvorlagen
Standardeinstellungen und gezielte Alarmierung
Alarmierung/Mitteilung zusammenfassen
Beschränkung in der kostenlosen Version
Einsatz-Rückmeldung
URL: https://www.divera247.com/api/confirm-alarm?accesskey=PERSÖNLICHER_ACCESSKEY
Folgende Parameter können via GET oder POST verwendet werden:
Parameter | Bedeutung |
---|---|
Confirmation[alarm_id] | ID des Einsatzes |
Confirmation[status_id] | ID des Status |
Confirmation[note] | Freitext-Rückmeldung |