Beschreibung
Abfrage, ob bei DIVERA 24/7 ein Einsatz ansteht, mit allen Einsatzdaten.
- Gerät
- Gira X1
- Version
- 1.0.0
- Lizenz
- Ein Schlüssel je X1 (MAC-Adresse), dauerhaft nutzbar
- Thema
- Sicherheit
Hinweis zur Schnittstelle: Der Baustein nutzt die Schnittstelle von DIVERA 24/7. Ändert der Anbieter sie oder stellt sie ein, kann der Baustein eingeschränkt oder gar nicht mehr funktionieren, bis er angepasst ist. Wir passen ihn nach Möglichkeit an, einen Anspruch darauf gibt es nicht.
Anleitung
Welcher API-Key?
DIVERA kennt drei Arten von API-Keys mit unterschiedlichen Rechten. Am Baustein wird die Art im Parameter „Art des API-Keys“ eingestellt. Davon hängen Filter und Fehlertexte ab.
| Art | Wo zu finden | Divera Alarm | Divera Status |
|---|---|---|---|
| Einheit | Verwaltung > Schnittstellen | alle Einsätze der Einheit | nicht möglich, DIVERA lehnt ab |
| Persönlich | Einstellungen > Debug (eigenes Konto) | nur Einsätze, bei denen der Benutzer adressiert ist | eigener Status, braucht das Recht „Status“ |
| Systembenutzer | Verwaltung > Benutzer (Systembenutzer anlegen) | braucht das Recht „Alarmierungen“ | Status einer anderen Person über deren Fremdschlüssel |
DIVERA empfiehlt, für jede Anwendung einen eigenen Systembenutzer bzw. API-Key zu verwenden und die Rechte auf das Nötigste zu beschränken.
Funktionen und Anschlüsse
Fragt ab, ob ein Einsatz anliegt (GET /api/last-alarm), und gibt die Einsatzdaten aus. Abgefragt wird nur, wenn der Eingang „Trigger“ den Wert 1 bekommt. Für eine laufende Überwachung „Trigger“ zyklisch senden, z. B. mit einem Taktgeber. DIVERA empfiehlt ein Intervall von mindestens 20 Sekunden, bei zu vielen Abfragen antwortet die API mit HTTP 429.
Parameter
| Parameter | Bedeutung |
|---|---|
| API-Key | Schlüssel laut Tabelle oben |
| Art des API-Keys | Einheit (Vorgabe), Persönlich oder Systembenutzer |
| Filter adressierter Benutzer (UCR-ID, 0 = aus) (ausgeblendet) | UCR-ID (Zuordnung Benutzer zu Einheit). Der Einsatz zählt nur, wenn diese UCR-ID adressiert ist. Enthält die Antwort von DIVERA keine Liste der adressierten Benutzer, zählt der Einsatz trotzdem. Vorgabe 0 = aus. Bei persönlichem Key ohne Wirkung, weil DIVERA dann selbst filtert |
| Lizenzschlüssel | Schlüssel für diesen X1, siehe „Lizenz“ |
Ausgänge
| Ausgang | Bedeutung |
|---|---|
| Einsatzalarm | 1, solange ein offener Einsatz anliegt. Bei einem beendeten Einsatz 0 |
| Stichwort, Meldung | Einsatzdaten |
| Datum/Uhrzeit | Alarmierungszeit, Format TT.MM.JJJJ hh:mm:ss |
| Impuls neuer Einsatz | 1 Sekunde 1 bei einem neuen Einsatz. Nach einem Neustart des X1 nur, wenn der Einsatz jünger als 5 Minuten ist |
| Sonderrechte, Angaben zum Objekt, Anrufer, Patient, Bemerkung, Anzahl gelesen, Einsatznummer (ausgeblendet) | unverändert aus DIVERA 24/7 |
| Einsatz-ID (ausgeblendet) | Für die Einsatzrückmeldung mit „Divera Status | SMoLabs“ |
| Breitengrad, Längengrad (ausgeblendet) | Koordinaten des Einsatzortes |
| Einsatzmittel, Fahrtziel, Zusatz 1, Zusatz 2, Zusatz 3 (ausgeblendet) | Weitere Felder der Alarmierung |
| Einsatz beendet (ausgeblendet) | 1, wenn DIVERA den Einsatz als beendet meldet |
| Anzahl Empfänger, Rückmeldung bis (ausgeblendet) | Empfänger und Ende des Rückmeldezeitraums |
| Selbst adressiert (persönlicher Key), Eigene Rückmeldung Status-ID (persönlicher Key) (ausgeblendet) | Nur mit persönlichem Key: ob man adressiert ist und welchen Status man zurückgemeldet hat |
| Adresse (ausgeblendet) | Einsatzort |
| Lizenzstatus, Debug | Lizenzprüfung, Ergebnis bzw. Fehler der letzten Abfrage |
Ausgeblendete Parameter und Ausgänge lassen sich im GPA (Gira Projekt Assistent) am Baustein einblenden.
Fehlerverhalten: Bei Verbindungsproblemen, HTTP 429 oder Serverfehlern bleiben die Ausgänge auf dem letzten Stand, damit ein laufender Einsatz nicht kurz verschwindet. Bei einem ungültigen Key (HTTP 401/403) werden sie zurückgesetzt. Der Grund steht unter „Debug“.
Lizenz
Der Lizenzschlüssel wird im GPA im Parameter „Lizenzschlüssel“ eingetragen. Der Baustein prüft ihn beim Start auf dem X1, offline und gebunden an die MAC-Adresse des X1. Der Ausgang „Lizenzstatus“ zeigt das Ergebnis, bei einem Schlüssel für ein anderes Gerät auch die MAC-Adresse dieses X1. Ohne gültigen Schlüssel bleibt der Baustein untätig. In der Simulation des GPA am PC läuft er ohne Lizenzprüfung, damit sich Logikblätter testen lassen. Jeder der beiden Bausteine braucht einen eigenen Schlüssel.
Den Schlüssel erhältst du beim Kauf über smolabs.de.
Verwendetes Icon: https://www.flaticon.com/de/kostenlose-icons/alarm Alarm Icons erstellt von Freepik – Flaticon
Changelog
Version 1.0.0
- Erste Version.
Rezensionen
Es gibt noch keine Rezensionen.