get https://api.gridx.de/clusters//appliances//flexibilities
The flexibility reflects the state of an appliance and its resulting operating constraints. Static information
about the appliances, e.g. manufacturer, model, serial number, and kind, is available via the DER Inventory API.
The concept of flexibility is general to all appliances. For example:
- in the case of an EVCS, the minActivePower and maxActivePower values reflect the min and max total operating power range of the EVCS; the activePower is the latest power value reported by the device.
- in the case of a meter at the grid connection point with the grid, the minActivePower (negative value) is the total feedin power limit, and the maxActivePower (positive value) is the total import limit. The activePower, if negative, reflects power being exported to the grid, whereas if positive, reflects the power being imported from the grid
- in the case of a battery, the min power (negative value) represents the max discharging power, whereas the max power (positive value) represents the max charging power. The power, when negative, reflects the fact that the battery is discharging, whereas when positive, reflects the power being charged by the battery.
- in the case of a PV inverter, the min power (negative value) represents the max power output of the inverter.
The flexibility has an invalidAt field, which indicates the time at which the flexibility can not be trusted anymore.
It may happen in the following cases:
- the appliance is no longer connected to the system
- the appliance is removed from the system
- the gateway is no longer connected to the system
The endpoint returns the latest stored flexibility of the appliance.