The Homey Energy Dongle includes a Local API that enables third-party clients to connect to it and retrieve data from the connected smart meter.
Enabling the Local API
To use the local API, you must first enable it in the Homey Energy Dongle’s settings.
1. Go to Devices
Open the Homey app and tap Devices in the tab bar.
2. Find the device
Find the Homey Energy Dongle and press and hold it.
3. Go to the settings
Tap the settings icon in the upper-right corner.
4. Find the Local API setting
Go to Advanced Settings, find the Local API setting, and set it to Enabled.
Using the Local API
The Homey Energy Dongle’s Local API is a WebSocket that can connect to any WebSocket-capable client. Once connected, the WebSocket will output the raw data received from the smart meter.
You can find an example on GitHub of how to connect to the Homey Energy Dongle’s Local API and parse the data from the smart meter.
Disabling the Local API
To disable the Local API, follow the same steps and set the setting to Disabled. This will disconnect all active Local API connections.
