Sensibo 空调控制

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

首次设置

1. 1. 从 https://home.sensibo.com/me/api 获取 API 密钥
2. 列出设备以获取 ID：

1. 3. 存储在 TOOLS.md 中：

| 房间 | 设备 ID |
|------|-----------|
| 客厅 | abc123 |
| 卧室 | xyz789 |

API 参考

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

开启/关闭

bash
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}}

设置温度

bash
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（除湿）

bash
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（自动）

bash
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}

完整状态变更

bash
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}}

空调状态属性

读取传感器数据

当前测量值

在字段中包含 measurements：
bash
curl --compressed https://home.sensibo.com/api/v2/pods/{device_id}?fields=measurements&apiKey={key}

响应包含：
json
{measurements: {temperature: 24.5, humidity: 55, time: 2024-01-15T12:00:00Z}}

历史数据

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

气候响应（智能自动化）

启用/禁用

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

配置阈值

bash
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

列出定时任务

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

创建定时任务

bash
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]
}

删除定时任务

bash
curl --compressed -X DELETE https://home.sensibo.com/api/v1/pods/{deviceid}/schedules/{scheduleid}/?apiKey={key}

定时器

设置一次性延迟操作：

bash
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. 1. 匹配房间名称： 当用户提到客厅或卧室时，在 TOOLS.md 中查找设备 ID
2. 检查响应： 验证 API 响应中的 status: success
3. 温度范围： 取决于具体空调设备的能力
4. 速率限制： 使用 --compressed 以获得更高的速率限制
5. 批量操作： 遍历设备 ID 执行关闭所有空调操作