docs: add OneNET API reference documentation
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,64 @@
|
||||
设备属性记录查询
|
||||
最近更新时间: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
|
||||
}
|
||||
Reference in New Issue
Block a user