Die eFriends WATCH+ und der eFriends Cube stellen die aktuellen Leistungsdaten über eine Schnittstelle zur Verfügung
Die Schnittstelle ist unter der folgenden Adresse im lokalen Netzwerk erreichbar:
http://<lokale IP-Adresse>/v3/MeterDataAPI/getCurrentValue
oder, von außerhalb des lokalen Netzwerks:
https://<hostname>/v3/MeterDataAPI/getCurrentValue
Den Wert für <hostname> kannst Du in der eFriends app im Expertenmodus abfragen.
Authentifizierung
Bei jeder Abfrage muss ein gültiger API-Key übergeben werden, entweder im HTTP-Header "apiKey" oder als URL-Parameter "apiKey". API-Keys kannst Du in der eFriends app im API Manager anlegen.
Ausgabe
Das Ausgabeformat kann über den Parameter "format" gesteuert werden
| format | Ausgabe |
| json (oder keine Angabe) | im JSON-Format |
| xml | im XML-Format |
Die folgenden Werte werden zurückgeliefert:
| Wert | Beschreibung |
| startTime, endTime |
Beginn und Ende des Zeitbereichs, in dem die Werte gemessen wurden. |
| energyBalance |
Gesamtleistung in Watt Zählrichtung: Werte größer als 0 bedeuten Einspeisung, Werte kleiner als 0 bedeuten Bezug |
| power1Watt, power2Watt, power3Watt | Leistung auf Phase 1, 2 bzw. 3 in Watt (nur wenn Deine Messung individuelle Phasen misst) |
| current1Ampere, current2Ampere, current3Ampere |
Strom auf Phase 1, 2 bzw. 3 in Ampere (nur wenn Deiner Messung Stromstärken misst) |
| voltage1Volt, voltage2Volt, voltage3Volt | Spannung auf Phase 1, 2 bzw. 3 in Volt (nur wenn Deine Messung Spannungen misst) |
Beispiele
Abfrage im lokalen Netzwerk als XML (mit fiktiver IP-Adresse und API-Key als Header)
$ curl http://10.0.0.5/v3/MeterDataAPI/getCurrentValue?format=xml -H 'apiKey: 8efd85c9-99df-4403-b0f2-6dfd5635ceb1'
<?xml version="1.0" encoding="utf-8"?>
<energyData>
<endTime>2018-06-19T22:57:40.000Z</endTime>
<startTime>2018-06-19T22:57:30.000Z</startTime>
<energyBalance>-2204.75</energyBalance>
<details>
<power1Watt>-325.25</power1Watt>
<power2Watt>-1795.5</power2Watt>
<power3Watt>-84</power3Watt>
<current1Ampere>2.3</current1Ampere>
<current2Ampere>8.1</current2Ampere>
<current3Ampere>1.4</current3Ampere>
<voltage1Volt>229.29999999999998</voltage1Volt>
<voltage2Volt>229.75</voltage2Volt>
<voltage3Volt>230.75</voltage3Volt>
</details>
</energyData>
Abfrage aus dem Internet als JSON (mit fiktivem Hostnamen und API-Key als URL-Parameter)
$ curl 'https://2e64965ab9b9f1903dd0efd0c38fde79.balena-devices.com/v3/MeterDataAPI/getCurrentValue?apiKey=8efd85c9-99df-4403-b0f2-6dfd5635ceb1'
{"endTime":"2018-06-19T22:57:40.000Z","startTime":"2018-06-19T22:57:30.000Z","energyBalance":-2204.75,
"details":{"power1Watt":-325.25,"power2Watt":-1795.5,"power3Watt":-84,
"current1Ampere":2.3,"current2Ampere":8.1,"current3Ampere":1.4,
"voltage1Volt":229.29999999999998,"voltage2Volt":229.75,"voltage3Volt":230.75}}
Kommentare
0 Kommentare
Bitte melden Sie sich an, um einen Kommentar zu hinterlassen.