Einführung und Prinzip
Einführung
Eine REST-API (Representational State Transfer Application Programming Interface) ist eine Schnittstelle, die es ermöglicht, Webdienste in ein bestehendes System zu integrieren.
Sie folgt den Prinzipien der REST-Architektur, um eine effiziente, skalierbare und einfache Kommunikation zwischen unterschiedlichen Systemen zu gewährleisten.
Durch den Einsatz standardisierter HTTP-Methoden wie z.B. GET und POST ermöglicht eine REST-API den Austausch von Daten und die Interaktion mit dem LOGIKEDITOR auf eine intuitive und benutzerfreundliche Weise.
Dies erleichtert die Erweiterung von Anwendungen und fördert gleichzeitig die Interoperabilität zwischen verschiedenen Systemen.
Prinzip
Der Grund für die Implementierung der REST-API direkt im LOGIKEDITOR liegt darin, dass dadurch Anfragen nicht nur direkt an das KNX-System weitergeleitet werden können, sondern bei Bedarf und ohne Umwege auch spezifische Funktionen (in Form von Logikgruppen) ausgelöst werden können.
Für eine nahtlose Integration der REST-API in den LOGIKEDITOR werden die Endpoints als Datenpunkte abgebildet. Auf diesen Weg können die http-Requests wie ein typischer Datenpunk im LOGIKEDITOR eingesetzt werden.
Damit ein http-Request vom EIBPORT verarbeitet werden kann, müssen die gewünschte Endpoints angelegt werden.
Diese werden im LOGIKEDITOR unter einen eigenen Menüpunkt („System“ / „Datenpunkte“ / „Intern + REST“) angelegt und verwaltet.
In der Logikgruppe sind diese Internen+Rest Datenpunkte wie ein KNX-Datenpunkte zu verwenden.
Damit die REST API im LOGIKEDITOR angesprochen werden kann, ist ein Teil fest vorgegeben. Das ist:
Der https-Port ist immer der Port 444
Der (fest vorgegebene) Pfad zur REST-API lautet „
/le/rest“
Daraus ergibt sich die Struktur für eine HTTP-Abfrage:
https://<IP ADRESSE>:444/le/rest/<Benutzerdefinierter Teil>///