Ga naar hoofdinhoud

buildings_electricity_sensors_actual

GET 
/public-api/buildings/:uuid/electricity/sensors/actual/

Pre-requisites​

  • uuid: You need a (building) uuid for this endpoint. You can get a list of buildings with GET /buildings/.
  • sensor_uuid: You need a sensor_uuid for this endpoint. You can get a list of sensors with GET /buildings/{uuid}/sensors/. Note: this is not the id of the sensor (example sensor_uuid: 153cde21-5967-4f25-b7f1-3325083c7695).

Retrieve actual electricity usage for sensor(s) of your building. Values are returned only if they are within one hour of the current time. Use (GET /buildings/{uuid}/electricity/sensors/latest/) to get the most recent value.
An object will be returned only if electricity usage data is available.

By default, this endpoint returns measurements with a timestamp of when they were recorded. It can also return minute-level aggregates with timestamps rounded to the nearest minute.

For combined sensor readings, the endpoint returns values only if all contributing sensors have provided data within 120 seconds of each other. To ensure the accuracy of the data, the timestamp of the oldest available reading is used to represent the overall data.

  • Aggregates: The endpoint returns the most recent combined result where data from all contributing sensors is available for that time period.

Unit: watt

Request​

Responses​