Technik & Vernetzung
REST-API & Webhooks: Raumklima integrieren
Die Ampel unterstützt Menschen direkt im Raum. Über REST-API und Webhooks können zusätzlich eigene Anwendungen und zuständige Teams Raumklima-Daten nutzen. So müssen Verantwortliche nicht jeden Raum selbst aufsuchen oder Messwerte manuell übertragen.

Auf einen Blick
- Lokale Assistenz und digitale Weitergabe ergänzen sich.
- REST-API liefert Daten aus der VIRTENIO Cloud; Webhooks melden dort konfigurierte Ereignisse.
- Ein klarer Empfänger und eine geplante Reaktion machen aus Daten einen hilfreichen Ablauf.
REST-API und Webhooks: zwei Wege über die Cloud
Vor Ort macht die Ampel Handlungsbedarf sichtbar. Für ein Gebäudeteam mit vielen Räumen ist zusätzlich wichtig, Daten am eigenen Arbeitsplatz nutzen zu können. Die dokumentierte REST-API greift auf die VIRTENIO Cloud-Plattform zu. Eine eigene Anwendung kann aktuelle oder historische Messdaten und Systemzustände abrufen und beispielsweise einem Raum-Dashboard zuordnen.
Damit entfällt das manuelle Sammeln einzelner Messwerte. Die lokale HLK-Empfehlung bleibt eine eigenständige Assistenzleistung: Die HLK Ampel bewertet CO₂, Temperatur und Feuchte gemeinsam; die Schnittstelle erweitert die Nutzung der verfügbaren Daten im eigenen Prozess.
Für die API-Nutzung werden die dokumentierte Cloud-Option, WLAN/Internet und passende Zugriffsrechte eingerichtet. Ein geschützter Abruf nutzt ein API-Token. Abrufrhythmus und Verarbeitung legt die eigene Anwendung fest; die hier beschriebene REST-API ist keine direkte lokale Geräte-API.1
Webhooks: Ereignisse melden statt regelmäßig abfragen
Ohne Ereignismeldung müsste eine Anwendung regelmäßig nachfragen oder ein Verantwortlicher die Anzeige verfolgen. Ein Webhook übermittelt bei einem definierten Cloud-Ereignis eine Meldung an den eingerichteten Empfänger. Regeln können CO₂, Temperatur oder relative Feuchte sowie Über- oder Unterschreitungen berücksichtigen. Eine Hysterese hilft, unnötig häufige Meldungen bei schwankenden Werten zu begrenzen.
Der praktische Nutzen liegt in der Weitergabe an die richtige Stelle: Ein Raumzustand wird im Gebäudemanagement sichtbar oder ein zuständiges Team kann informiert werden. Eine solche Cloud-Regel ist gesondert konfiguriert; sie ist nicht automatisch eine identische Kopie der gesamten HLK-Empfehlungslogik.2
REST-API: gezielter Abruf. Webhook: Meldung durch eine konfigurierte Cloud-Regel.
Eine Integration vom gewünschten Ablauf her planen
Beginnen Sie mit dem gewünschten Ergebnis: Messwerte in der eigenen Oberfläche, ein Hinweis für das Gebäudeteam oder eine geplante Folgereaktion. Während die Menschen vor Ort bereits von der Ampel unterstützt werden, kann die Integration den Informationsweg über Raumgrenzen hinweg verkürzen.
Für eine Folgereaktion werden Empfängerformat, Zugriffsrechte und Zuständigkeit festgelegt. Soll eine Anlage automatisch schalten, braucht es zusätzlich eine geeignete, geprüfte Umsetzung im Zielsystem. Auch der Umgang mit ausbleibenden Meldungen wird dort definiert.
Ein Hinweis für das Gebäudeteam
Beispiel: Eine Einrichtung betreut mehrere Schulungsräume. Die Cloud-Regel meldet eine vereinbarte Auffälligkeit an einen eigenen Dienst, der sie dem zuständigen Gebäudeteam mit Raumzuordnung bereitstellt. Vor Ort bleibt die Ampel für die Nutzer sichtbar.
Damit muss niemand sämtliche Messwertansichten ständig offen halten. Die lokale Assistenz erleichtert das unmittelbare Handeln; die digitale Meldung hilft, wiederkehrende oder organisatorisch relevante Situationen an die richtige Stelle zu bringen.
Eine gute Schnittstellenanfrage enthält fünf Angaben
- Zielsystem und verantwortliche IT-Ansprechperson.
- Benötigte Messgrößen, Räume und Zeitraum.
- Regelmäßiger Datenabruf oder ereignisbezogene Meldung.
- Geplante Reaktion, Zugriffsrechte und Empfängerformat.
- Umgang mit fehlender Verbindung und ausbleibenden Meldungen.
Mit dieser Beschreibung lässt sich prüfen, welche vorhandenen VIRTENIO-Funktionen passen und welche Arbeit im Zielsystem erforderlich ist. Die lokale Webansicht ist dabei ein anderer Zugang als die hier beschriebene Cloud-REST-API.1, 2
Quellen und Vertiefung
- VIRTENIO: REST-API: HLK-Handbuch, Kapitel 7.7Cloudbasierter API-Zugriff, Bucket-ID, Daten und Autorisierung; kein direkter Zugriff auf das Gerät.
- VIRTENIO: Webhooks: HLK-Handbuch, Kapitel 7.10Cloud-Regeln, Messgrößen, Schwellwerte, Hysterese und Übergabeformate.




