Query Energy Consumption Trend

Last Updated on : 2023-06-21 07:13:08download

Query energy statistics data of devices in a space within a specified time range, including the usage, generation, or dump statistics regarding water, electricity, and natural gas.

API address

GET: /v1.0/iot-03/energy/{energy_type}/devices/statistics-trend

Request parameter

Parameter name Type IN Required Description
energy_type String uri true The energy type. Set the value to electricity.
energy_action String query true The energy behavior. Set the value to consume, representing energy consumption.
statistics_type String query true The statistical type. Valid values:
  • month: by month, in the format of yyyyMM. The maximum span is 12 months, and you can only query the data of the last 12 months.
  • day: by day, in the format of yyyyMMdd. The maximum span is 7 days, and you can only query the data of the last 90 days.
  • hour: by hour, in the format of yyyyMMddHH. The maximum span is 24 hours, and you can only query the data of the last 7 days.
start_time String query true The start time.
end_time String query true The end time.
device_id String query true The device ID.

Return parameter

Parameter name Type Description
result List

Description of result

Parameter name Type Description
time String The time.
value Float The energy data.

Request example

GET: /v1.0/iot-03/energy/electricity/devices/statistics-trend?energy_action=consume&statisticsType=hour&startTime=2021092316&endTime=2021092318&deviceId=xxx

Return example

{ "result": [ { "time": "2021092316", "value": 0 }, { "time": "2021092317", "value": 0 }, { "time": "2021092318", "value": 0 } ], "t": 1632465751328, "success": true }

Error code

For more information, see error code.