Wenn Messwerte in eigenen Programmen verwendet werden sollen, bietet die OUT-App JSON den einfachen Zugriff auf Kanäle und Messwerte. Die Daten werden im Format JSON bereit gestellt.
Damit der Zugriff noch schneller und einfacher möglich ist, stellen wir zwei Bibliotheken zum Zugriff auf die Kanäle und Messwerte bereit:
- PHP
- Javascript
Damit wir ein Messwert superleicht zugreifbar.
PHP
Mit einer Zeile kann mit PHP auf Messwerte zugegriffen werden. Die „valueid“ ist die Kennung des Messwerts, z.B. 91-4. Dieser Wert kann in der App-Hilfe oder mit der Funktion
$valueid = $api->getChannelsResponse()->getChannels()[0]->getValueid();
ermittelt werden. Anschließend kann über folgende Funktion der Wert des Sensors abgefragt werden.
$value = $api->getValuesResponse($valueid)->getValues()[0]->getValue();
Den PHP-Client und ein Programmbeispiel gibt’s zum Download unter https://github.com/siwiat/out-app-json-client-php
JavaScript
Mit einer Zeile kann mit JavaScript auf Messwerte zugegriffen werden. Die „valueid“ ist die Kennung des Messwerts, z.B. 91-4. Dieser Wert kann in der App-Hilfe oder mit der Funktion
getChannelsResponse(...)
ermittelt werden. Über die „valueid“ kann anschließend über folgende Funktion der Wert des Sensors abgefragt werden.
apiValues.getValuesResponse(data.channels[0].valueid, values_callback);
Den JavaScript-Client und ein Programmbeispiel gibt’s zum Download unter https://github.com/siwiat/out-app-json-client-js-sample
SIWIAT OUT-App JSON
Die SIWIAT OUT-App JSON muss für für die Beispiele auf der SIWIAT App-Box installiert sein. Die Clients können mit GIT installiert werden.
Weiterentwicklung
Wenn Sie Interesse an der Weiterentwicklung der Clients für eigene Zwecke haben: Fork us on Github! Viel Erfolg. Wir freuen uns über Feedback, Stars und Watches.
JavaScript Client | PHP Client |
---|---|