Ga naar hoofdinhoud

buildings_electricity_sensors_latest

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

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 latest electricity usage for sensor(s) of your building, this will always return the last value regardless of how old it is (where GET /buildings/{uuid}/electricity/sensors/actual/ returns no value when it's too old).
It will only return an object for a sensor if electricity usage is available.

By default this endpoint will return measurements with a timestamp of the moment they were measured. If specified this endpoint can also return minute aggregates of measurements instead. Since theses aggregates are made every minute, aggregates have a timestamp rounded to a full 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​