名称： sensibo
描述： 通过 Sensibo REST API 控制智能空调设备。当用户要求开关空调、调节温度、设置模式、查询室内温湿度或管理气候计划时使用。触发短语示例："打开空调"、"把卧室调到22度"、"现在有多热"、"关空调"、"制冷模式"。

Sensibo 空调控制

通过 Sensibo REST API 控制智能空调设备。

首次设置

1. 从 https://home.sensibo.com/me/api 获取 API 密钥。
2. 列出设备以获取其 ID：
   bash curl --compressed "https://home.sensibo.com/api/v2/users/me/pods?fields=id,room&apiKey={API_KEY}"

3. 将信息存储在 TOOLS.md 文件中：
   ``markdown ## Sensibo API 密钥：`

   房间	设备 ID
   客厅	abc123
   卧室	xyz789
   ```

API 参考

基础 URL： https://home.sensibo.com/api/v2
认证： 使用查询参数 ?apiKey={key}
始终使用： --compressed 标志以获得更好的速率限制。

开关空调

curl --compressed -X POST "https://home.sensibo.com/api/v2/pods/{device_id}/acStates?apiKey={key}" \
  -H "Content-Type: application/json" -d '{"acState":{"on":true}}'

设置温度

curl --compressed -X PATCH "https://home.sensibo.com/api/v2/pods/{device_id}/acStates/targetTemperature?apiKey={key}" \
  -H "Content-Type: application/json" -d '{"newValue":23}'

设置模式

可选值：cool（制冷）, heat（制热）, fan（送风）, auto（自动）, dry（除湿）

curl --compressed -X PATCH "https://home.sensibo.com/api/v2/pods/{device_id}/acStates/mode?apiKey={key}" \
  -H "Content-Type: application/json" -d '{"newValue":"cool"}'

设置风速

可选值：low（低）, medium（中）, high（高）, auto（自动）

curl --compressed -X PATCH "https://home.sensibo.com/api/v2/pods/{device_id}/acStates/fanLevel?apiKey={key}" \
  -H "Content-Type: application/json" -d '{"newValue":"auto"}'

完整状态变更

curl --compressed -X POST "https://home.sensibo.com/api/v2/pods/{device_id}/acStates?apiKey={key}" \
  -H "Content-Type: application/json" \
  -d '{"acState":{"on":true,"mode":"cool","targetTemperature":22,"fanLevel":"auto","temperatureUnit":"C"}}'

空调状态属性

读取传感器数据

当前测量值

在 fields 参数中包含 measurements：

curl --compressed "https://home.sensibo.com/api/v2/pods/{device_id}?fields=measurements&apiKey={key}"

响应示例：

{"measurements": {"temperature": 24.5, "humidity": 55, "time": "2024-01-15T12:00:00Z"}}

历史数据

curl --compressed "https://home.sensibo.com/api/v2/pods/{device_id}/historicalMeasurements?days=1&apiKey={key}"

气候反应（智能自动化）

启用/禁用

curl --compressed -X PUT "https://home.sensibo.com/api/v2/pods/{device_id}/smartmode?apiKey={key}" \
  -H "Content-Type: application/json" -d '{"enabled":true}'

配置阈值

curl --compressed -X POST "https://home.sensibo.com/api/v2/pods/{device_id}/smartmode?apiKey={key}" \
  -H "Content-Type: application/json" \
  -d '{
    "enabled": true,
    "lowTemperatureThreshold": 20,
    "lowTemperatureState": {"on": true, "mode": "heat"},
    "highTemperatureThreshold": 26,
    "highTemperatureState": {"on": true, "mode": "cool"}
  }'

计划任务

注意： 计划任务使用 API v1 基础 URL：https://home.sensibo.com/api/v1

列出计划

curl --compressed "https://home.sensibo.com/api/v1/pods/{device_id}/schedules/?apiKey={key}"

创建计划

curl --compressed -X POST "https://home.sensibo.com/api/v1/pods/{device_id}/schedules/?apiKey={key}" \
  -H "Content-Type: application/json" \
  -d '{
    "targetTimeLocal": "22:00",
    "timezone": "Europe/London",
    "acState": {"on": false},
    "recurOnDaysOfWeek": ["sunday","monday","tuesday","wednesday","thursday","friday","saturday"]
  }'

删除计划

curl --compressed -X DELETE "https://home.sensibo.com/api/v1/pods/{device_id}/schedules/{schedule_id}/?apiKey={key}"

定时器

设置一次性延迟操作：

curl --compressed -X PUT "https://home.sensibo.com/api/v1/pods/{device_id}/timer/?apiKey={key}" \
  -H "Content-Type: application/json" \
  -d '{"minutesFromNow": 30, "acState": {"on": false}}'

使用提示

1. 匹配房间名称： 当用户提及“客厅”或“卧室”时，从 TOOLS.md 中查找对应的设备 ID。
2. 检查响应： 确认 API 响应中包含 "status": "success"。
3. 温度范围： 可设置的温度范围取决于具体空调型号的能力。
4. 速率限制： 使用 --compressed 标志以获得更高的 API 调用速率限制。
5. 批量操作： 对于“关闭所有空调”这类请求，可以遍历设备 ID 列表进行操作。