查询设备指标聚合
调用此接口,查询设备某一参数的指标聚合。
接口路径
/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
}
]
}