Überblick
Welche Schnittstellen in LORVIS hinein- und hinausführen – wer jeweils ruft, womit er sich ausweist und ob ein Einsatz entsteht.
LORVIS hat vier Arten von Schnittstellen. Sie unterscheiden sich darin, wer ruft und womit er sich ausweist – und das ist keine Formalie, sondern bestimmt, was schiefgehen kann.
| Weg | Wer ruft | Ausweis | Legt einen Einsatz an |
|---|---|---|---|
| Alarmeingang | Alarmierungssystem | Geheimnis je Quelle | ja |
| Fahrzeugstatus | Leitstelle, FMS | dasselbe Geheimnis | nie |
| Geräte-API | die Fahrzeugtablets | Gerätetoken | ja (vom Fahrzeug aus) |
| LARDIS:ONE Connect | das Funkgerät (umgekehrt: es ruft LORVIS) | Token in der Adresse | nie |
| API-Schlüssel | eigene Programme | Schlüssel je Organisation | – |
Warum Alarm und Status getrennte Adressen haben
Das ist die wichtigste Entscheidung an diesen Schnittstellen, und sie ist ausdrücklich so getroffen worden:
Ein Alarm ist ein Ereignis – „hier ist etwas passiert" – und er legt einen Einsatz an. Ein Status ist ein Zustand des Fahrzeugs: „dieses Fahrzeug ist jetzt 2".
Die FMS-Stufen 1, 2 und 6 haben mit keinem Einsatz zu tun. Beides über dieselbe Adresse zu schicken hieße: jede Statusmeldung trägt die Bedeutung eines Alarms mit sich. Ein Zahlendreher, ein Feld zu viel – und aus „Fahrzeug wieder frei" wird ein Einsatz.
Das ist die Sorte Fehler, die niemand rückgängig macht, weil sie nachts um drei auf sechs Tablets aufblinkt. Deshalb: eigener Weg, dasselbe Geheimnis, und der Statuseingang legt nie einen Einsatz an.
Die Adressen
| Zweck | Adresse |
|---|---|
| Alarm | https://manager.lorvis.de/api/v1/alarme |
| Fahrzeugstatus | https://manager.lorvis.de/api/v1/fahrzeugstatus |
Die vollständige Adresse samt Geheimnis steht im Portal unter Organisation → Alarmquelle, je eingerichteter Quelle. Sie dort abzuschreiben ist zuverlässiger als sie hier zusammenzusetzen.
Die Beschreibung zum Weitergeben
Wer die Anbindung nicht selbst baut, sondern einem Dienstleister überlässt, gibt ihm die Seite Webhook – dort stehen alle Felder, die der Alarmeingang versteht. Für die Geräte-API steht die vollständige OpenAPI-Beschreibung offen unter lorvis.de/api-doku; im Portal ist sie unter Schnittstellen → Schnittstellenbeschreibung auch zum Ausprobieren eingerichtet.
Organisationen und Daten
Wem welche Daten in LORVIS gehören – warum jede Angabe genau einer Organisation zugeordnet ist und wie Nachbarn trotzdem etwas sehen.
Wie der Alarmeingang arbeitet
Das Grundprinzip aller Alarmquellen – eine gemeinsame Adresse, das Geheimnis sagt, wer ruft, und fünf Zustände zeigen, ob es läuft.