Skip to main content

System (/api/v1/system)

The /api/v1/system endpoint can be used to configure system settings. Currently the only available option it to turn on and off all cloud communication.

This feature is currently only available for:

  • P1 Meter (HWE-P1)
  • Energy Socket (HWE-SKT)
  • kWh Meter 1-phase (HWE-KWH1 / SDM230-wifi)
  • kWh Meter (HWE-KWH3 / SDM630-wifi)
  • Watermeter (HWE-WTR)

Enable cloud​

The HomeWizard Energy devices are designed to work with the HomeWizard Energy app and require communication with the HomeWizard cloud to make them function with the app.

The Enable cloud configuration feature can be used to turn off all communication with the HomeWizard cloud, making the device fully local. The device cannot communicate with the app, and the device won't receive any future firmware updates.

Cloud communication is restored when the cloud_enabled is set to true. Cloud communications are also restored after a factory reset, or when the device is put in pairing mode.

Be clear

If you are implementing this, make sure your user understand what this actions does. Users may press a button without knowing what they do and forget about it. In this case it seems that the app or device is broken and reach out to our support, and we would like to prevent that.

You can solve this, for example, by adding clear documentation and/or by showing a confirmation popup before calling this endpoint.

This endpoint accepts GET and PUT requests.

  • With GET will send the actual system state.
  • With PUT allows to set the system state.

Examples​

Get system state​

<Request>
GET http://{IP address}/api/v1/system HTTP/1.1

<Response>
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: <length>

{
   "cloud_enabled": true
}

Set system state​

<Request>
PUT http://{IP address}/api/v1/system HTTP/1.1
{
   "cloud_enabled": false
}

<Response>
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: <length>

{
   "cloud_enabled": false
}