76 lines
2.2 KiB
Plaintext
76 lines
2.2 KiB
Plaintext
设备属性最新数据查询
|
|
最近更新时间：2026-01-16 16:47:29
|
|
接口功能
|
|
根据产品id和设备名，查询设备最新属性功能点数据
|
|
|
|
备注
|
|
支持OneJson、自定义透传数据协议，设备能正常下发上报
|
|
|
|
接口地址
|
|
https://iot-api.heclouds.com/thingmodel/query-device-property
|
|
|
|
API说明
|
|
请求方式：GET
|
|
|
|
http query 请求参数：
|
|
|
|
参数 类型 是否必选 描述
|
|
product_id string 是 产品ID，平台生成唯一ID
|
|
device_name string 是 设备名称
|
|
返回数据
|
|
|
|
参数名称 类型 描述
|
|
code int 调用成功或失败时，返回的code码
|
|
msg string 调用成功或失败时，返回的msg信息
|
|
request_id string 调用API生成的请求标识
|
|
data - 调用成功时，返回的业务数据
|
|
data.list array 设备属性数据集合
|
|
data.list字段结构
|
|
|
|
[
|
|
{
|
|
"identifier": string, # 功能点标识
|
|
"time": string, # 上报时间，毫秒时间戳
|
|
"value": string, # 功能点上报值，json字符串
|
|
"data_type": string, # 数据类型 int32、int64、float、double、enum、bool、string、struct、bitMap
|
|
"access_mode": string, # 读写类型
|
|
"expect_value": string, # 期望值, json字符串，属性功能点具有该字段
|
|
"name": string, # 功能点名称
|
|
"description": string, # 功能描述
|
|
}
|
|
]
|
|
示例
|
|
请求示例
|
|
|
|
GET http(s)://iot-api.heclouds.com/thingmodel/query-device-property
|
|
?product_id=9MaNe52pNO&device_name=no001
|
|
|
|
响应示例
|
|
|
|
{
|
|
"data":[
|
|
{
|
|
"access_mode": "读写",
|
|
"data_type": "int32",
|
|
"description": "二氧化碳",
|
|
"expect_value": "800",
|
|
"identifier": "CO2",
|
|
"name": "二氧化碳",
|
|
"time": "1592797444539",
|
|
"value": "600"
|
|
},
|
|
{
|
|
"access_mode": "读写",
|
|
"data_type": "bool",
|
|
"description": "关",
|
|
"expect_value": "true",
|
|
"identifier": "fan",
|
|
"name": "风扇",
|
|
"time": "1592797444539",
|
|
"value": "false"
|
|
}
|
|
],
|
|
"request_id": "a25087f46df04b69b29e90ef0acfd115",
|
|
"msg": "succ",
|
|
"code": 0
|
|
} |