查询指定维度节点能源数据时间趋势

更新时间:2021-09-30 09:23:40下载pdf

本文介绍查询指定维度节点能源数据时间趋势的 API。

接口描述

查询一定时间范围内,资产下或者自定义维度下的能源统计数据,包括水、电、气的使用、生成或转储统计数据。

接口地址

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

请求参数

参数名 类型 参数位置 是否必填 说明
energy_type String uri true 能源类型,仅支持电: electricity
energy_action String query true 能源行为,仅支持消耗: consume
dimension_code String query true 维度 Code,支持 asset(资产)或其它自定义维度 Code
node_ids String query true 指定维度节点 ID,最多支持 10 个节点
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 结束时间

返回参数

参数名 类型 说明
result List

result 说明

参数名 类型 说明
node_id String 维度节点
items List 能源数据时间趋势

items 说明

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

请求示例

GET: /v1.0/iot-03/energy/electricity/statistics?energy_action=consume&dimension_code=asset&node_ids=138803317715****&statistics_type=hour&start_time=2021080422&end_time=2021080423

返回示例

{ "result": [ { "items": [ { "time": "2021080400", "value": 10 }, { "time": "2021080401", "value": 20 } ], "node_id": "123432" }, { "items": [ { "time": "2021080400", "value": 10 }, { "time": "2021080401", "value": 20 } ], "node_id": "2423232" } ], "t": 1624525873263, "success": true }

错误码

参考 错误码