多设备用电趋势汇总统计

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

本文介绍多设备用电趋势汇总统计的 API。

接口描述

一定时间范围内,多设备用电趋势汇总统计。

接口地址

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

请求参数

参数名 类型 参数位置 是否必填 说明
energy_type String uri true 能源类型,仅支持电:electricity
energy_action String query true 能源行为,仅支持消耗:consume
statistics_type String query true 统计粒度。
  • month:月,格式为 yyyyMM,最大跨度12个月,只能查询最近一年的数据
  • day:天,格式为 yyyyMMdd,最大跨度 7 天,只能查询最近 90 天的数据
  • hour:小时,格式为 yyyyMMddHH,最大跨度 24 小时,只能查询最近 7 天的数据
start_time String query true 开始时间
end_time String query true 结束时间
device_ids String query true 设备 ID 集合
contain_childs Boolean query true 是否包含子节点数据,默认 true

返回参数

参数名 类型 说明
result List 响应结果

result 说明

参数名 类型 说明
time String 时间
value Float 能源数据

请求示例

GET: /v1.0/iot-03/energy/electricity/devices/nodes/statistics-trend?energy_action=consume&statisticsType=day&startTime=20210925&endTime=20210926&containChilds=false&device_ids=6c5ef5dc7fabc34138****,erwerwerwe****

返回示例

{
    "result": [
        {
            "time": "20210925",
            "value": 0
        },
        {
            "time": "20210926",
            "value": 0
        }
    ],
    "t": 1641459342692,
    "success": true
}

错误码

参考 错误码