云服务 API 参考行业场景垂直行业解决方案电量统计用电统计多设备用电趋势汇总统计

多设备用电趋势汇总统计

更新时间：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
}

错误码

参考错误码。

上一篇多设备用电趋势汇总统计

下一篇自定义纬度统计