查询节点总用电量

更新时间:2023-06-21 07:13:09

本文介绍查询节点总用电量的 API。

接口描述

查询资产下指定节点的总用电量。

接口地址

GET: /v1.0/iot-03/energy/{energy_type}/space/nodes/statistics-sum

请求参数

参数名类型参数位置是否必填说明
energy_typeStringuritrue能源类型,仅支持 electricity:电
energy_actionStringquerytrue能源行为,仅支持 consume:消耗
statistics_typeStringquerytrue统计粒度。
  • month:月,格式为 yyyyMM,最大跨度12个月,只能查询最近一年的数据
  • day:天,格式为 yyyyMMdd,最大跨度7天,只能查询最近 90 天的数据
  • hour:小时,格式为 yyyyMMddHH,最大跨度 24 小时,只能查询最近 7 天的数据
start_timeStringquerytrue开始时间
end_timeStringquerytrue结束时间
space_idsStringquerytrue节点集合
contain_childsBooleanquerytrue是否包含子节点数据,默认值为 true

返回参数

参数名类型说明
resultFloat统计结果

请求示例

GET: /v1.0/iot-03/energy/electricity/space/nodes/statistics-sum?energy_action=consume&statisticsType=day&startTime=20210925&endTime=20210926&containChilds=false&space_ids=147355207358382****,147355203680817****

返回示例

{
    "result": 50,
    "t": 1641378388380,
    "success": true
}

错误码

参考 错误码