LoxoneLoxone – Beispiel-Anlage
1
API Zugang aktivieren
API Zugang ist aktiviert.
2
Export-Datei herunterladen und entpacken
(nach Anmeldung verfügbar)
– die Export-Datei enthält zwei Ordner (Befehle und Rückmeldungen).
Sicherheitshinweis: Diese Daten sind vertraulich und Ihrer Anlage eindeutig zugeordnet. Teilen Sie sie nicht mit Dritten und bewahren Sie heruntergeladene Dateien sicher auf. Bei Verdacht auf Kompromittierung können Sie Zugangsdaten jederzeit im Portal neu generieren.
3
„Loxone Config" Programm öffnen und auf „Virtuelle Eingänge" navigieren.
4
In der oberen Menüleiste auf „Vordefinierte HTTP Geräte" klicken und danach auf „Vorlage importieren" klicken.
5
Danach die gewünschten Datenpunkte aus dem Ordner „Rückmeldungen" auswählen und öffnen.
6
Beim nochmaligen Klick auf „Vordefinierte HTTP Geräte" erscheinen die importierten Eingänge in der Liste, nun einfach anklicken und der Eingang wird in Loxone angelegt.
7
Auf „Virtuelle Ausgänge" navigieren.
8
In der oberen Menüleiste auf „Vordefinierte Geräte" klicken und danach auf „Vorlage importieren" klicken.
9
Danach die gewünschten Datenpunkte aus dem Ordner „Befehle" auswählen und öffnen.
10
Beim nochmaligen Klick auf „Vordefinierte Geräte" erscheinen die importierten Ausgänge in der Liste, nun einfach anklicken und der Ausgang wird in Loxone angelegt.
11
Nach dem Import jeden Virtuellen Ausgang öffnen und unter Simulation/LiveView den Anzeigetyp auf „Taster (Schließer)" setzen.
Wichtig: Der Loxone Miniserver benötigt den expliziten Port
:443 in der URL. Verwenden Sie immer https://cbnode.at:443/... statt https://cbnode.at/....
Loxone Integration – Loxone unterstützt keine Custom HTTP-Header, daher wird der API Key als URL-Parameter übergeben (
?api_key=...).
Die Konfiguration erfolgt im Loxone Config Tool unter Virtueller HTTP-Eingang.
Schritte: Loxone Config → Peripherie → Virtueller HTTP-Eingang → neue Verbindung anlegen → URL eintragen → Virtuellen Eingangsbefehl für jeden Wert anlegen.
Sicherheitshinweis: Diese Daten sind vertraulich und Ihrer Anlage eindeutig zugeordnet. Teilen Sie sie nicht mit Dritten und bewahren Sie heruntergeladene Dateien sicher auf. Bei Verdacht auf Kompromittierung können Sie Zugangsdaten jederzeit im Portal neu generieren.
API Key
X-Api-Key: {key}URL:
?api_key={key}
Bearer Token
Authorization: Bearer {token}URL:
?token={token}
Hub + Gruppen Status auslesen:
Hub Status: URL: https://cbnode.at:443/api/v1/hub/0012AB34/status?api_key=IHR_API_KEY Erkennung: "mode":"\v" → ARMED, DISARMED, NIGHT Gruppen Status: URL: https://cbnode.at:443/api/v1/hub/0012AB34/groups?api_key=IHR_API_KEY Erkennung Gruppe 1: "id":"00000001","name":"\i","mode":"\v" Erkennung Gruppe 2: "id":"00000002","name":"\i","mode":"\v"
Hub + Gruppen steuern (Virtueller HTTP-Ausgang):
Hub scharf/unscharf:
URL: https://cbnode.at:443/api/v1/hub/0012AB34/command?api_key=IHR_API_KEY
Body EIN: {"command": "ARM"} | Body AUS: {"command": "DISARM"}
Gruppe scharf/unscharf (Gruppe-ID z.B. 00000001):
URL: https://cbnode.at:443/api/v1/hub/0012AB34/groups/00000001/command?api_key=IHR_API_KEY
Body EIN: {"command": "ARM"} | Body AUS: {"command": "DISARM"}
Gerät Bypass ein/aus:
URL: https://cbnode.at:443/api/v1/hub/0012AB34/devices/{GERAET_ID}/bypass?api_key=IHR_API_KEY
Body EIN: {"bypass": true} | Body AUS: {"bypass": false}
Gerätestatus auslesen (state, alarm, tamper):
URL: https://cbnode.at:443/api/v1/hub/0012AB34/devices?api_key=IHR_API_KEY Auslösung: "name":"Gerätename","state":"\v" → 0=ruhig / 1=ausgelöst Alarm: "name":"Gerätename","alarm":"\v" → 0=kein Alarm / 1=Alarm Sabotage: "name":"Gerätename","tamper":"\v" → 0=OK / 1=Sabotage Störung: "name":"Gerätename","malfunction":"\v" → 0=OK / 1=Störung Batterie: "name":"Gerätename","battery":"\v" → 0–100 %