查询设备指标聚合
调用此接口,查询设备某一参数的指标聚合。
接口路径
/api/deviceStat/agglog/{pk}/{devId}
请求方式
[GET]
请求参数
路径参数:
参数名称 | 数据类型 | 是否必须 | 说明 |
---|---|---|---|
pk | String | 是 | 产品pk |
devId | String | 是 | 设备ID |
Headers:
参数名称 | 参数值 | 是否必须 |
---|---|---|
Content-Type | application/x-www-form-urlencoded | 是 |
Authorization | {token} | 是 |
- 其中token获取方式参考使用AccessKey计算token。
Query:
参数名称 | 数据类型 | 是否必须 | 说明 |
---|---|---|---|
startTime | number | 是 | 查询开始时间(ms) |
endTime | number | 是 | 查询结束时间(ms) |
key | String | 是 | 所查询设备的参数标识 |
span | String | 是 | 查询聚合力度 |
【注意】:
- 其中
key
必须为number型参数; - 其中聚合力度
span
可选值为5min
、1hour
和1day
,对应的最大时间范围为一周
、一个月
和一年
。 即,当span
值选择为5min
时,startTime
和endTime
差值不能大于一周。
【示例】:
http://**3.*9.*1.**2:8***/api/deviceStat/agglog/848f4fc************85e63e35159783/t*****1?startTime=1578878730279&endTime=1578882330279&key=power&span=5min
返回参数
名称 | 类型 | 说明 |
---|---|---|
avgList | array | 参数平均值聚合列表 |
maxList | array | 参数最大值聚合列表 |
minList | array | 参数最小值聚合列表 |
value | number | 对应聚合值 |
timestamp | number | 聚合时间(ms) |
【示例】:
{
"avgList": [
{
"timestamp": 1578882300000,
"value": 0.3333333432674408
},
{
"timestamp": 1578882000000,
"value": 0.25
}
],
"maxList": [
{
"timestamp": 1578882300000,
"value": 1.0
},
{
"timestamp": 1578882000000,
"value": 1.0
}
],
"minList": [
{
"timestamp": 1578882300000,
"value": 0.0
},
{
"timestamp": 1578882000000,
"value": 0.0
}
]
}