用途:通过 Homebridge Config UI X 的 REST API 控制 HomeKit 兼容的智能家居设备,包括列出配件、开关设备、调节亮度、颜色和温度。
前提条件:需已安装并运行 Homebridge 与 Config UI X;凭据文件位于 ~/.thinkfleet/credentials/homebridge.json,包含 url、username、password 字段。
认证:所有 API 调用需 Bearer token,先通过 POST ${HOMEBRIDGE_URL}/api/auth/login 获取 access_token。
主要能力:列出所有配件(GET /api/accessories,返回 uniqueId、serviceName、type 及当前值);获取房间布局(GET /api/accessories/layout);控制配件(PUT /api/accessories/{uniqueId},通过 characteristicType 与 value 更新特性)。常见特性包括 On(true/false)、Brightness(0-100)、Hue(0-360)、Saturation(0-100)、ColorTemperature(140-500 Mired)、TargetTemperature(10-38°C)、TargetHeatingCoolingState(0=Off,1=Heat,2=Cool,3=Auto)、RotationSpeed(0-100)、Active(0/1)。
使用方式:可直接用 curl 调用 API,也可使用提供的脚本 scripts/homebridge_api.py,支持 list(可按 --room、--type 过滤)、set <uniqueId> <特性> <值>、get <uniqueId>。
限制与提示:特性名称区分大小写(如 On 而非 on);部分配件可能有多个服务,需检查响应中的服务类型;token 会过期,遇到 401 需重新认证;完整端点文档见 {HOMEBRIDGE_URL}/swagger。