设备属性最新数据查询
最近更新时间：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
}