Versionen im Vergleich

Schlüssel

  • Diese Zeile wurde hinzugefügt.
  • Diese Zeile wurde entfernt.
  • Formatierung wurde geändert.

...

Info

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)BedeutungDatentypBemerkung
idIdentifier eines bestehenden Datensatzes
numberEinsatznummerInteger
, dient dem Zusammenführen/Aktualisieren
Eigene Nummer des Einsatzes, z.B. laufende Einsatznummer der Leitstelle.
numberNummerString oder Integer
titleEinsatzstichwortString
, max 50 Zeichen
Auf 50 Zeichen begrenzt (bei FREE 30 Zeichen). Wird in der Push Nachricht angezeigt.
priorityPriorität/Sonderrechte
String, 0 = aus, 1 = ein
Boolean/Integertrue oder 1, um Feld zu aktivieren
text
Meldung
MeldungstextStringLängerer Text mit Detailinformationen. Länge max. 1000 Zeichen
addressAdresseString
, max

Maximal 200 Zeichen ab ALARM Version

lngBreitengradFloatKomma durch Punkt ersetzen
latLängengradFloatKomma durch Punkt ersetzen
ricAlarmierte Gruppe(n) oder Untereinheit(en) 
coordinatesAnweisung für
StringAlarmierungs-RIC, mehrere Werte kommasepariert angeben
vehicleAlarmierte Fahrzeug(e) StringAlarmierungs-RIC, mehrere Werte kommasepariert angeben
personAlarmierte Person(en)StringFremdschlüssel, mehrere Werte kommasepariert angeben

Parameter (erweitert)BedeutungDatentypBemerkung
delaySekunden die seit dem Alarm vergangen sindIntegerKorrigiert die Uhr im Alarmmonitor
coordinatesAktiviert ein abweichendes KoordinatensystemStringErlaubte Werte: gk
coordinates-xX-Wert
der Koordinate
einer Koordinate im Gauß-Krüger FormatFloatNur erlaubt, wenn coordinates den Wert gk hat
Float
coordinates-yY-Wert
der Koordinate
einer Koordinate im Gauß-Krüger FormatFloat
ricUntereinheit(en) und Gruppe(n) gemäß dem Feld Alarmierungs-RICString, mehrere Werte mit Komm trennenpersonPerson(en) gemäß dem Feld FremdschlüsselString, mehrere Werte mit Komm trennenvehicleFahrzeug(e) gemäß dem Feld Alarmierungs-RICString, mehrere Werte mit Komm trennencluster_idsIDs von UntereinheitenInteger als
Nur erlaubt, wenn coordinates den Wert gk hat
newsMitteilung statt einer Alarmierung erstellenBoolean/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)BedeutungDatentypBemerkung
idPrimärschlüssel einer bestehenden AlarmierungIntegerDient dem dem Aktualisieren einer bestehenden Meldung, kann über /last-alarm ausgelesen werden
cluster_idsPrimärschlüssel von UntereinheitenInteger-Array
group_ids
IDs von
Primärschlüssel von GruppenInteger
als
-Array
user_cluster_relation_ids
IDs von
Primärschlüssel von BenutzernInteger
als
-Array
vehicle_ids
IDs von
Primärschlüssel von EinsatzfahrzeugenInteger
als
-Array
delayVerzögerung seit dem Alarm, in SekundenInteger

Nummer (number)

Eigene Nummer des Einsatzes, z.B. laufende Einsatznummer der Leitstelle.

Einsatzstichwort (title)

Das Einsatzstichwort, auf 50 Zeichen begrenzt (bei FREE 30 Zeichen). Wird in der Push Nachricht angezeigt.

Priorität/ Sonderrechte (priority)

Bool/ Wahrheitswert, true oder false

Meldung (text)

Längerer Text mit Detailinformationen. Länge max. 1000 Zeichen

...


alarmcode_idPrimärschlüssel einer AlarmvorlageInteger

Übertragung der Adresse (ab ALARM Version)

Die Adresse, wird zur Darstellung des EInsatzortes Einsatzortes auf der Karte verwendet. Länge max. , sie kann maximal 200 Zeichen

Wenn Sie der Schnittstelle nur die Adresse übergeben und die Koordinaten nicht im Aufruf enthalten sind, versucht die Schnittstelle diese mittels Geocoding zu ermitteln.

Längen- und Breitengrad (lat, lng)

...

In Süddeutschland wird in Alarmdepeschen noch häufig das Koordinatensystem Gauß Krüger/Deutsches Hauptdreiecksnetz (DHDN) verwendet.

...

Nutzen Sie folgende Parameter:

coordinates = gk
coordinates-x = Rechtswert
coordinates-y = Hochwert

Die Gauß-Krüger-Zone wird automatisch anhand der hinterlegten Adresse der Einheit ermittelt.

Angabe von Empfängern/gezielte Alarmierung

Erweitern
titleHier klicken, zum Ausklappen

Alarmierte Untereinheiten (ric, cluster_ids)

In der PRO-Version mit einheitsübergreifender Funktionalität, können über die zentrale Alarm-Schnittstelle mehrere Untereinheiten mit einem einzigen Aufruf der API alarmiert werden. 
Sie können den Parameter "ric" analog zu Gruppen und Fahrzeugen verwenden. Die Datenpflege der "Alarmierungs-RIC" erfolgt jedoch über den zentralen Administrator in den Vorgaben der Untereinheiten.

...

 Der Parameter "cluster_ids" erwartet ein Array mit den Primärschlüsseln der Einheit(en).

...

 Zur schnelleren Verarbeitung wird empfohlen, die IDs der Einheiten als Array zu übergeben.

Alarmierte Untereinheiten und Gruppen (ric, group_ids)

Die Gruppen, die alarmiert werden sollen. Verwenden Sie die Schreibweise aus dem Feld "Alarmierungs-RIC" oder die IDs der gewünschten Gruppen.

...

 Der Parameter "ric" erwartet einen String mit einer oder mehrerer RICs. Mehrere mit Komma getrennt.

...

 Der Parameter "user_cluster_relation_ids" erwartet ein Array mit den Primärschlüsseln der Gruppe(n).

...

 In DIVERA 24/7 PRO können über den API-Key der zentralen Schnittstelle auch einheitsübergreifende Gruppen (z.B. alle Führungskräfte im Stadtgebiet) alarmiert werden.

Alarmierte Personen (person, user_cluster_relation_ids)

Die Benutzer, die alarmiert werden sollen. Verwenden Sie die Schreibweise aus dem Feld "Fremdschlüssel" oder die IDs der gewünschten Einsatzkräfte.

...

 Der Parameter "person" erwartet einen String mit einem oder mehreren Fremdschlüsseln. Mehrere mit Komma getrennt.

...

 Der Parameter "user_cluster_relation_ids" erwartet ein Array mit den Primärschlüsseln der Einsatzkräfte.


Alarmierte Fahrzeuge (vehicle, vehicle_ids)

Die Einsatzmittel, die alarmiert werden sollen. Mehrere mit Komma getrennt. Verwenden Sie die Schreibweise aus dem Feld "Alarmierungs-RIC".

...

 Der Parameter "vehicle" erwartet einen String mit einer oder mehrerer RICs. Mehrere mit Komma getrennt.

...

 Der Parameter "vehicle_ids" erwartet ein Array mit den Primärschlüsseln der Datensätze

...

Zeit seit dem Alarm (delay)

Die Sekunden, die seit dem Alarm vergangen sind. Korrigiert die Uhr im Alarmmonitor

Mitteilung statt Alarm auslösen (news)

Über den Parameter "news=1" oder die URL https://www.divera247.com/api/news?accesskey=API_KEY wird eine normale Mitteilung mit leiser Benachrichtigung erzeugt.

...

.


Wichtige Hinweise

Auswertung von Alarmvorlagen

...