Skip to main content

Push API

Updated

We offer a possibility yourself about one HTTP Request Send electricity meter, inverter and Home Battery. This gives you the option of controlling devices intelligently where the energy data cannot be accessed on the Internet.

 

A scenario would be, for example, if you let a script run on a device in the local network, which periodically questions the inverter and then sends the data to us.

 

Preparation

In order to be able to send data to us, you need to have a electricity meter with the type Push API create. Choose Push API out and press on [Further].

 

Create one now API Key in which you on [Create] press. This is used for authentication and should be treated confidentially.

 
 

With the displayed URL you can use HTTP-POST Request Can send data.

 
 

Integration

Since you have now created a valid URL, you can send your energy data to us. Content-Type Is always application/json. The numerical values ​​are to be transferred as a whole number (integers).

 

Examples

House consumption

{
"watt": -1000
}
 

This only transmits your home consumption. Negative value means that it is fed into the public network (excess). Positive value means network cover (consumption).

 

House consumption and PV production

{
"watt": -1000,
"producingWatt": 1500
}
 

In the field "producingWatt" the current PV proposal is transmitted. The value is always positive.

 

House consumption, PV production and Home Battery

 
{
"watt": -1000,
"producingWatt": 1500,
"soc": 75,"chargingPower": 500,
"powerStorageState": 1
}
 

In the field "soc" Will be the current one State of Charge transmitted in the percentage of your battery. In the field "chargingPower" Will the Charge/discharge out of your battery transmitted. The value is always positive.

Depending on whether your battery is currently loading, unloading or having another status, this information is in "powerStorageState" transmitted. The following values ​​are permitted:

 
Idle : 0
Charging : 1
Disabled : 2
Discharging : 3
 

In the case of successful sending, status Code 202 (Accepted) responded.

 

Note: The data sent is not updated immediately in the frontend. Instead, these are temporarily stored for further processing. The value in the display is updated about every 15 seconds. The API has one Rate-Limit von 180 Requests pro Minute.

Related articles