65 lines
1.8 KiB
Plaintext
65 lines
1.8 KiB
Plaintext
设备属性记录查询
|
|
最近更新时间：2026-01-16 16:47:29
|
|
接口功能
|
|
根据产品id设备名称时间范围等参数，查询设备属性历史功能点数据
|
|
|
|
备注
|
|
支持OneJson、自定义透传数据协议，设备能正常下发上报
|
|
|
|
接口地址
|
|
https://iot-api.heclouds.com/thingmodel/query-device-property-history
|
|
|
|
API说明
|
|
请求方式：GET
|
|
|
|
http query 请求参数：
|
|
|
|
参数 类型 是否必选 描述
|
|
product_id string 是 产品ID，平台生成唯一ID
|
|
device_name string 是 设备名称
|
|
identifier string 是 属性功能点标识
|
|
start_time string 是 查询起始时间，毫秒时间戳
|
|
end_time string 是 查询结束时间，毫秒时间戳
|
|
sort string 否 排序参数 1-正序 2-倒序 默认倒叙
|
|
offset string 否 请求起始位置，默认0
|
|
limit string 否 每次请求记录数，默认10, 范围[1, 100]
|
|
返回数据
|
|
|
|
参数名称 类型 描述
|
|
code int 调用成功或失败时，返回的code码
|
|
msg string 调用成功或失败时，返回的msg信息
|
|
request_id string 调用API生成的请求标识
|
|
data - 调用成功时，返回的业务数据
|
|
data.list array 设备属性数据集合
|
|
data.list字段结构
|
|
|
|
[
|
|
{
|
|
"value": string, # 属性功能点上报值
|
|
"time": int, # 属性功能点上报时间
|
|
}
|
|
]
|
|
示例
|
|
请求示例
|
|
|
|
GET http(s)://iot-api.heclouds.com/thingmodel/query-device-property-history
|
|
?product_id=9MaNe52pNO&device_name=no001&identifier=someDate&start_time=1681713647000&end_time=1681799966562
|
|
|
|
响应示例
|
|
|
|
{
|
|
"data": [
|
|
{
|
|
"time": "1592810751988",
|
|
"value": "false"
|
|
},
|
|
{
|
|
"time": "1592810746988",
|
|
"value": "true"
|
|
}
|
|
],
|
|
"request_id": "a25087f46df04b69b29e90ef0acfd115",
|
|
"msg": "succ",
|
|
"code": 0
|
|
}
|