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,49 @@
+获取设备属性详情
+最近更新时间：2026-01-16 16:47:29
+接口功能
+根据产品ID和设备名，下发物模型属性获取命令到设备，设备返回属性值到接口
+
+备注
+仅支持OneJson设备，需要设备在线
+
+接口地址
+https://iot-api.heclouds.com/thingmodel/query-device-property-detail
+
+API说明
+请求方式：POST
+
+http body 请求参数：
+
+参数	类型	是否必选	描述
+product_id	string	是	产品ID，平台生成唯一ID
+device_name	string	是	设备名称
+params	array	是	功能点标识数组，expample: ["light","model"]
+返回数据
+
+参数名称	类型	描述
+code	int	调用成功或失败时，返回的code码
+msg	string	调用成功或失败时，返回的msg信息
+request_id	string	调用API生成的请求标识
+data	-	调用成功时，返回的业务数据
+示例
+请求示例
+
+POST  http(s)://iot-api.heclouds.com/thingmodel/query-device-property-detail
+Content-type: application/json
+{
+  "product_id":"B7EEW578EbRg5Y4K",
+  "device_name":"device3",
+  "params":["light","model"]
+}
+
+响应示例
+
+{
+    "request_id": "a25087f46df04b69b29e90ef0acfd115",
+    "msg": "succ",
+    "code":  0,
+    "data":{
+         "light":1,
+         "model":1
+    }
+}