Das Template bietet eine Möglichkeit, Zählerdaten direkt vom Zähler zu lesen
Voraussetzung: Modbus TCP muss auf dem Zähler aktiviert werden. Die IP oder der DNS-Name des Zählers muss im Template eingetragen werden.
Das Template bietet eine Möglichkeit, Zählerdaten von unserer Cloud zu lesen und digitale Ausgänge zu steuern.
Hinweis: Basic Auth wird abgeschaltet um die wachsenden Security-Anforderungen zu erfüllen.
Nur noch bis November 2026 möglich (bis v.1.0.2)
Im Template muss vor dem URL des API Calls der Benutzername und das Passwort des Kontos stehen. Der Benutzername muss je nach dem von smart-me gesetzt werden.
Das Template bietet eine Möglichkeit, Zählerdaten von unserer Cloud zu lesen und digitale Ausgänge zu steuern.
Hinweis: Loxone bietet keine einfachere Möglichkeit mit API-Keys umzugehen. Die unten beschrieben Prozedur wurde zusammen mit Loxone erarbeitet. API-Keys wurden eingeführt um die wachsenden Security-Anforderungen zu erfüllen.
ab Version 1.0.3
Login im smart-me Portal --> Menu Schnittstellen --> API --> Oben im orangen Banner auf den "Link" klicken --> "Neu erstellen".
Den API Key eine Bezeichnung geben, z.B. Loxone,
Das Ablaufdatum setzen
Die Berechtigungen setzen. Für Loxone reicht "device.readswitch" (Wenn es im Browser automatisch auf deutsch übersetzt wird, bitte "Gerät.LesenSchalten" verwenden)
Erstellen
API Key kopieren. Achtung: Der Key kann danach nicht wieder abgerufen werden.
Der API-Key wird später benötigt.
Allgemein:Weitere Infos zu den Berechtigungen: API
Wenn das Konto auf Professional ist, kann die DeviceID ganz einfach
Menu System --> Systemgesundheit
Geräte suchen
Die Geräte-ID wird später verwendet. z.B. 61c71d00-3d40-4963-745b2-7c6b0c512gf3
Wenn das Konto nicht Lizenziert ist, muss die DeviceID über die API geholt werden.
1. Windowstaste drücken und "cmd" eingeben.
2. Die Eingabeaufforderung öffnen
3. Folgenden Befehl in die Eingabe kopieren.
Achtung: Den ApiKey anpassen.
curl -X "GET" "https://api.smart-me.com/Devices" -H "accept: */*" -H "Authorization: ApiKey n9CUnYCGmTOQZCCX1iHRqrF5Erzx9pUu"
4. In der Antwort nach dem Zählernamen suchen und die Id rauskopieren.
Das template aus der Loxone Library herunterladen (VO_XXXX). (Siehe Link weiter oben)
Oben im Menu Loxone unter "Vordefinierte Geräte" den smart-me Request laden.
Ein neuer virtueller Ausgang erscheint, dort auf den Befehl "Meter" klicken.
Im Feld "Befehl bei EIN" muss <meter.id> mit der Geräte-ID ersetzt werden.
Im Feld "HTTP header bei EIN" muss <apikey> mit der API-Key ersetzt werden. Hinweis: Der API-Key kann bei jedem Zähler vom selben Konto derselbe sein.
Im Feld "HTTP-Antwort speichern" muss der text smartmeapi.html angepasst werden.
Der Name muss für jeden Ausgang individuell sein. z.B. bilanz.html Beispiel user/common/bilanz.html
Das template aus der Loxone Library herunterladen (VI_XXXX).
Unter "Vordefinierte HTTP-Geräte" den smart-me meter laden.
Ein neuer virtueller Eingang erscheint
Auf den Eingang "smart-me meter" klicken.
Beim Feld "URL" müssen folgende Fehler angepasst werden.
Zugangsdaten des Loxone Miniservers
IP
Name des HTML Files hinterlegt. Dabei ist für denselben Befehl derselben Name wie oben notwendig. z.B. bilanz.html.
Beispiel von einem Befehl:
https://admin:sicheres_admin_passwort@127.0.0.1/bilanz.html
Wenn nicht das smart-me Template verwendet wird, muss der "Virtuelle Ausgang Befehl" mittels Impulsgenerator angesteuert werden.
Das Modul bietet eine Möglichkeit, Zählerdaten zu unserer Cloud zu senden.
Wichtig: Dieses Modul ist nicht von smart-me entwickelt. Wir bieten dafür keinen Support. Das Wissen um dieses Modul zu verwenden musst du dir selber aneignen und ist aus unsere Sicht für fortgeschritten Loxone Users.
Diese Anleitung bietet nur eine kleine Übersicht wie eine Messpunkt erstellt werden kann, was nicht über das Loxone Modul stattfindet.
API Key im Smart-me Portal erstellen mit den Claims: device.readwrite und user.readwrite (Nur ein Key pro Konto ist nötig, nicht für jeden Zähler)
Folgenden call ausführen (Felder davor editieren (ApiKey & Name))
Mit Power-Shell:
curl -i -X 'POST' 'https://api.smart-me.com/Devices' -H 'accept: text/plain' -H 'Authorization: ApiKey <apikey>' -H 'Content-Type: application/json-patch+json' -d '{"activePower": 0, "counterReading": 0, "counterReadingExport": 0, "valueDate": "2025-07-08T08:15:55.026Z", "name": "Loxone Beispiel", "deviceEnergyType": 1}'
Mit Windows CMD (DOS):
curl -i -X POST "https://api.smart-me.com/Devices" -H "accept: text/plain" -H "Authorization: ApiKey <apikey> " -H "Content-Type: application/json" -d "{\"activePower\": 0, \"counterReading\": 0, \"counterReadingExport\": 0, \"valueDate\": \"2025-12-05T00:00:00.000Z\", \"name\": \"Loxone Beispiel\", \"deviceEnergyType\": 1}"
Die UUID des Zählers aus dem Response nehmen.
Alternative 1: UUID aus Systemgesundheit im Dashboard holen
Alternative 2: https://api.smart-me.com/Devices GET verwenden um alle IDs zu erhalten.
Diese Daten müssen in der Loxone Library eingetragen werden.
Zusammengefasst wurde so ein Zähler über die API erstellt, welcher dann in Loxone verwendet werden kann.