docs: add OneNET API reference documentation

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-06-03 11:11:09 +08:00
parent 69e13f504f
commit 0845c38b72
10 changed files with 840 additions and 0 deletions
@@ -0,0 +1,76 @@
+设备属性最新数据查询
+最近更新时间：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
+}