设备数据查询接口（QueryAPI）功能与用法说明

基本信息

接口路径： api.qicloud.tech/api/device/case/query

请求方法：POST

请求头：Authorization: <token>

请求体：JSON

功能描述：根据设备类型和功能参数，查询窗帘、灯光、传感器等设备的状态或历史数据。

通用请求参数

字段名	类型	必填	说明
device_id	string	是	设备ID
family_id	string	是	家庭组ID
function	string	是	查询功能（见下表）
param	object	否	查询参数（部分功能需要）

支持的功能与用法

1. 智能窗帘（equip_curtain）

1.1 查询当前状态

function: get_curtain_current_status

请求示例：

{
  "device_id": "equip_curtain_005",
  "family_id": "family001",
  "function": "get_curtain_current_status"
}

响应示例：

{
  "status": "open",
  "position": 100
}

1.2 查询操作日志（历史数据）

function: get_curtain_recent_data

请求示例：

{
  "device_id": "equip_curtain_005",
  "family_id": "family001",
  "function": "get_curtain_recent_data"
}

响应示例：

[
  {"action": "open", "status": "success", "timestamp": "2025-07-27T10:00:00Z"},
  {"action": "close", "status": "success", "timestamp": "2025-07-27T09:00:00Z"}
]

1.3 查询当前位置

function: get_curtain_current_position

请求示例：

{
  "device_id": "equip_curtain_005",
  "family_id": "family001",
  "function": "get_curtain_current_position"
}

响应示例：

{
  "position": 100
}

2. 智能灯光（equip_light）

2.1 查询当前状态

function: get_light_current_status

请求示例：

{
  "device_id": "equip_light_005",
  "family_id": "family001",
  "function": "get_light_current_status"
}

响应示例：

{
  "on": true,
  "brightness": 80,
  "tone": "warm"
}

2.2 查询操作日志（历史数据）

function: get_light_recent_data

请求示例：

{
  "device_id": "equip_light_005",
  "family_id": "family001",
  "function": "get_light_recent_data"
}

响应示例：

[
  {"action": "on", "status": "success", "timestamp": "2025-07-27T10:00:00Z"},
  {"action": "off", "status": "success", "timestamp": "2025-07-27T09:00:00Z"}
]

3. 温湿度传感器（sensor_dht）

3.1 查询当前状态

function: get_dht_current_status

请求示例：

{
  "device_id": "equip_dht_001",
  "family_id": "family001",
  "function": "get_dht_current_status"
}

响应示例：

{
  "temperature": 25.5,
  "humidity": 60
}

3.2 查询历史数据

function: get_dht_recent_data

请求示例：

{
  "device_id": "equip_dht_001",
  "family_id": "family001",
  "function": "get_dht_recent_data"
}

响应示例：

[
  {"temperature": 25.5, "humidity": 60, "timestamp": "2025-07-27T10:00:00Z"},
  {"temperature": 24.8, "humidity": 62, "timestamp": "2025-07-27T09:00:00Z"}
]

4. 人体存在传感器（sensor_humanexist）

4.1 查询当前状态

function: get_humanexist_current_status

请求示例：

{
  "device_id": "sensor_humanexist_001",
  "family_id": "family001",
  "function": "get_humanexist_current_status"
}

响应示例：

{
  "audio": 0.2,
  "movement": 1,
  "light": 0.8
}

4.2 查询历史数据

function: get_humanexist_recent_data

请求示例：

{
  "device_id": "sensor_humanexist_001",
  "family_id": "family001",
  "function": "get_humanexist_recent_data"
}

响应示例：

[
  {"audio": 0.2, "movement": 1, "light": 0.8, "timestamp": "2025-07-27T10:00:00Z"},
  {"audio": 0.1, "movement": 0, "light": 0.7, "timestamp": "2025-07-27T09:00:00Z"}
]

5. 门窗传感器（sensor_doorandwindow）

5.1 查询当前状态

function: get_doorandwindow_current_data

请求示例：

{
  "device_id": "sensor_doorandwindow_001",
  "family_id": "family001",
  "function": "get_doorandwindow_current_data"
}

响应示例：

{
  "door": "open",
  "action": "manual"
}

5.2 查询历史数据

function: get_doorandwindow_recent_data

请求示例：

{
  "device_id": "sensor_doorandwindow_001",
  "family_id": "family001",
  "function": "get_doorandwindow_recent_data"
}

响应示例：

[
  {"door": "open", "action": "manual", "timestamp": "2025-07-27T10:00:00Z"},
  {"door": "close", "action": "auto", "timestamp": "2025-07-27T09:00:00Z"}
]

通用响应错误示例

参数错误：

{
  "code": 400,
  "message": "请求参数错误: ..."
}

无效token：

{
  "code": 401,
  "message": "无效的访问令牌: ..."
}

无权限：

{
  "code": 403,
  "message": "用户无权访问该家庭组"
}

服务内部错误：

{
  "code": 500,
  "message": "服务内部错误: ..."
}

备注

所有查询均需携带有效的 Bearer Token。

function 字段需与设备类型和功能严格对应。

历史数据默认返回最近 50 条。

设备数据查询接口（QueryAPI）功能与用法说明

设备数据查询接口（QueryAPI）功能与用法说明#

基本信息#

通用请求参数#

支持的功能与用法#

1. 智能窗帘（equip_curtain）#

1.1 查询当前状态#

1.2 查询操作日志（历史数据）#

1.3 查询当前位置#

2. 智能灯光（equip_light）#

2.1 查询当前状态#

2.2 查询操作日志（历史数据）#

3. 温湿度传感器（sensor_dht）#

3.1 查询当前状态#

3.2 查询历史数据#

4. 人体存在传感器（sensor_humanexist）#

4.1 查询当前状态#

4.2 查询历史数据#

5. 门窗传感器（sensor_doorandwindow）#

5.1 查询当前状态#

5.2 查询历史数据#

通用响应错误示例#

备注#

设备数据查询接口（QueryAPI）功能与用法说明

基本信息

通用请求参数

支持的功能与用法

1. 智能窗帘（equip_curtain）

1.1 查询当前状态

1.2 查询操作日志（历史数据）

1.3 查询当前位置

2. 智能灯光（equip_light）

2.1 查询当前状态

2.2 查询操作日志（历史数据）

3. 温湿度传感器（sensor_dht）

3.1 查询当前状态

3.2 查询历史数据

4. 人体存在传感器（sensor_humanexist）

4.1 查询当前状态

4.2 查询历史数据

5. 门窗传感器（sensor_doorandwindow）

5.1 查询当前状态

5.2 查询历史数据

通用响应错误示例

备注