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.0 KiB

Raw Blame History

hide

toc

!!! info "Référence en anglais" Les noms de méthodes, de champs, de types et les descriptions ci-dessous sont ceux de l'API elle-même, en anglais. Ils sont laissés tels quels : ce sont les chaînes que vous écrirez dans vos requêtes. Seules les pages d'explication sont traduites.

Référence API JsonRPC

ETM PowerSync expose l'API JSON-RPC de nymea en local, y compris les extensions ETM (Energy, AirConditioning, EvDash).

Connexion

Mode	Adresse	Notes
TCP brut	`<ip>:2222`	nymea parle en premier (welcome JSON `\n`-delimited)
WebSocket	`ws://<ip>:4444`	le client envoie `JSONRPC.Hello` en premier

Authentification

Appeler JSONRPC.Authenticate avec username, password et deviceName → reçoit un token.
Inclure le token dans chaque requête suivante.
Activer les push : JSONRPC.SetNotificationStatus { "enabled": true }.

Conventions énergie

Grandeur	Convention
Production PV	valeur négative (convention producteur)
`currentPowerAcquisition`	réseau — positif = import, 0 si export
`currentPowerStorage`	batterie — positif = charge, négatif = décharge
Totaux d'énergie	en kWh
Timestamps	en secondes (Unix epoch)

Badges de permission

Badge	Scope	Description
AUTH	`PermissionScopeNone`	Tout compte authentifié (token requis dès que le transport exige l'authentification ; seuls `JSONRPC.Hello`, `Authenticate` et `RequestPushButtonAuth` passent sans)
CONTROL	`PermissionScopeControlThings` / `ExecuteRules`	Contrôle des appareils et règles
CONFIGURE	`PermissionScopeConfigureThings` / `ConfigureRules`	Configuration
ADMIN	`PermissionScopeAdmin`	Administration système

2.0 KiB Raw Blame History