Build & Deploy docs / build-deploy (push) Successful in 3m52s

Details

api : référence régénérée depuis le banc en 1.15.2+etm71 (droits NymeaEnergy.* séparés, GetOptimizerProtocol)

Le badge PUBLIC de PermissionScopeNone devient AUTH : sur un transport
authentifié, nymea exige un token valide pour toute méthode sauf
JSONRPC.Hello, Authenticate et RequestPushButtonAuth
(jsonrpcserverimplementation.cpp, tag 1.15.2). « Lecture publique, aucun
token requis » était faux, en trois langues.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

2026-10-20 08:49:15 +02:00

2.1 KiB

Raw Blame History

JSON-RPC-API Unterstützt

ETM PowerSync stellt die JSON-RPC-API von nymea lokal bereit, erweitert um die ETM-Namensräume (Energy, AirConditioning, EvDash).

Verbindung

Modus	Adresse	Hinweise
Rohes TCP	`<ip>:2222`	Der Server sendet beim Verbinden eine Willkommensnachricht als JSON (`\n`-getrennt)
WebSocket	`ws://<ip>:4444`	Der Client sendet zuerst `JSONRPC.Hello`

Jede Nachricht ist ein JSON-Objekt, abgeschlossen mit \n. Anfragen enthalten ein Feld id (Ganzzahl), um die Antwort zuzuordnen. Benachrichtigungen haben kein id.

Authentifizierung

JSONRPC.Authenticate mit username, password und deviceName aufrufen → der Server antwortet mit einem token.
Das token in jede weitere Anfrage aufnehmen.
Um Benachrichtigungen zu erhalten: JSONRPC.SetNotificationStatus mit { "namespaces": ["Energy", "Integrations", ...] } aufrufen.

Energie-Konventionen

Größe	Konvention
PV-Erzeugung	negativer Wert (Erzeugerkonvention)
`currentPowerAcquisition`	Netz — positiv = Bezug, 0 bei Einspeisung
`currentPowerStorage`	Speicher — positiv = Laden, negativ = Entladen
Energiesummen	in kWh
Zeitstempel	in Sekunden (Unix-Epoch)

Berechtigungs-Badges

Badge	Scope	Beschreibung
AUTH	`PermissionScopeNone`	Jedes angemeldete Konto (Token nötig, sobald der Transport Authentifizierung verlangt; nur `JSONRPC.Hello`, `Authenticate` und `RequestPushButtonAuth` gehen ohne)
CONTROL	`PermissionScopeControlThings` / `ExecuteRules`	Steuerung von Geräten und Regeln
CONFIGURE	`PermissionScopeConfigureThings` / `ConfigureRules`	Konfiguration von Integrationen und Regeln
ADMIN	`PermissionScopeAdmin`	Systemadministration

Vollständige Referenz

→ JSON-RPC-API-Referenz

2.1 KiB Raw Blame History