查询单个设备多个属性的历史数据聚合

开发中

iot-dev.utapp.cn

https://iot-dev.utapp.cn

POST

/api/deviceProperty/get/device/properties/historyAgg

请求参数

Header 参数

Authorization-Type

string

必需

默认值:

X-Authorization

string

必需

默认值:

Body 参数application/json

使用示例及注意事项：这个interval 时间间隔单位为秒，结束时间 - 起始时间为时间跨度，一般建议时间间隔要参考时间跨度大小来定，比如，按天查，聚合的时间间隔不要少于30秒按周查，聚合的时间间隔不要小于15分钟按月查，聚合的时间间隔不要小于1小时以此类推，总的条数在 5000 条以内较好，太多聚合时间过长，

string

设备Id

必需

identifiers

array[string]

属性标识数组

必需

interval

integer

时间间隔，秒

必需

aggregation

string

必需

聚合条件，MIN，MAX，AVG，SUM，COUNT

startTime

integer

必需

int64,起始时间，毫秒

endTime

integer

必需

int64,结束时间，毫秒

timeStep

string

必需

STAND时间不处理，FORWARD时间往前推，BACKWARD往后推

sort

string

ASC，DESC

必需

示例

    {
        "aggregation": "MAX",
        "startTime": 1718640000000,
        "endTime":   1720419798000,
        "interval": 600,
        "id": "wszcZkkucih",
        "identifiers": [
            "inclination"
        ],
        "sort": "ASC",
        "timeStep": "FORWARD"
    }

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://iot-dev.utapp.cn/api/deviceProperty/get/device/properties/historyAgg' \
--header 'Authorization-Type;' \
--header 'X-Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
        "aggregation": "MAX",
        "startTime": 1718640000000,
        "endTime":   1720419798000,
        "interval": 600,
        "id": "wszcZkkucih",
        "identifiers": [
            "inclination"
        ],
        "sort": "ASC",
        "timeStep": "FORWARD"
    }'

返回响应

🟢200成功

application/json

Body

string

设备ID

必需

data

object

数据Map

必需

key为属性标识，value为TsVDto数组

示例

{
    "id": "string",
    "data": {}
}

修改于 2024-08-05 06:11:29

统计键值时长