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