联犀-things

聚合属性历史记录

POST

/api/v1/things/device/msg/property-agg/index

things/device/msgthingsDeviceMsg

请求参数

Header 参数

Ithings-Project-Id

string

可选

默认值:

Ithings-Token

string

可选

默认值:

app-code

string

可选

默认值:

device-id

string

可选

用户正在使用的设备ID(小程序,ios,安卓的设备ID)

Body 参数application/json

tenantCode

string

只有管理员有权限

可选

projectID

string

只有管理员有权限

可选

areaID

string

只有管理员有权限

可选

areaIDPath

string

只有管理员有权限

可选

areaIDs

array[string]

只有管理员有权限

可选

belongGroup

object

可选

key是group的purpose, value是里面包含的分组id 只有partitionBy 传该参数的时候才会返回

deviceName

string

可选

设备名(不填获取产品下所有设备)

deviceNames

array[string]

可选

设备名(不填获取产品下所有设备,只有管理员有权限)

productID

string

可选

产品id 获取产品id下的所有设备信息

productCategoryID

integer <int64>

可选

产品品类id,通用物模型有效

timeStart

string

获取时间的开始

可选

timeEnd

string

时间的结束

可选

partitionBy

string

可选

切分数据,可以填写deviceName

aggs

array[object (DeviceMsgPropertyAgg) {4}]

聚合对象

必需

dataID

string

可选

获取的具体标识符的数据

argFuncs

array[string]

必需

聚合函数 avg:平均值 first:第一个参数 last:最后一个参数 count:总数 twa: 时间加权平均函数参考: https:docs.taosdata.com/reference/taos-sql/function/#apercentile

fill

string

可选

指定窗口区间数据缺失的情况下的填充模式参考: https:docs.taosdata.com/reference/taos-sql/distinguished/#fill-%E5%AD%90%E5%8F%A5

noFirstTs

boolean

可选

时间戳填充不填充最早的值,聚合模式使用

示例

{
    "tenantCode": "string",
    "projectID": "string",
    "areaID": "string",
    "areaIDPath": "string",
    "areaIDs": [
        "string"
    ],
    "belongGroup": {},
    "deviceName": "string",
    "deviceNames": [
        "string"
    ],
    "productID": "string",
    "productCategoryID": 0,
    "timeStart": "string",
    "timeEnd": "string",
    "partitionBy": "string",
    "aggs": [
        {
            "dataID": "string",
            "argFuncs": [
                "string"
            ],
            "fill": "string",
            "noFirstTs": true
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/v1/things/device/msg/property-agg/index' \
--header 'Ithings-Project-Id: {{Ithings-Project-Id}}' \
--header 'Ithings-Token: {{iThings-token}}' \
--header 'app-code: {{appCode}}' \
--header 'device-id;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "tenantCode": "string",
    "projectID": "string",
    "areaID": "string",
    "areaIDPath": "string",
    "areaIDs": [
        "string"
    ],
    "belongGroup": {},
    "deviceName": "string",
    "deviceNames": [
        "string"
    ],
    "productID": "string",
    "productCategoryID": 0,
    "timeStart": "string",
    "timeEnd": "string",
    "partitionBy": "string",
    "aggs": [
        {
            "dataID": "string",
            "argFuncs": [
                "string"
            ],
            "fill": "string",
            "noFirstTs": true
        }
    ]
}'

返回响应

🟢200成功

application/json

A successful response.

Body

code

integer

返回code

可选

默认值:

200

msg

string

返回的消息

可选

data

object (DeviceMsgPropertyAggIndexResp)

可选

示例

{
    "code": "200",
    "msg": "string",
    "data": {}
}

修改于 2025-07-05 02:25:32

获取云端诊断日志

获取最新属性记录