Home Assistant API
Home Assistant API
Home Assistant API 是开源智能家居平台的本地控制接口：智能设备状态、自动化、场景、跨厂商集成（2500+ 集成）。
完全开源 (Apache 2.0)
要自己跑 server（Raspberry Pi 或 NUC）
本地起 Home Assistant 实例。Profile → 创建 long-lived access token。GET http://homeassistant.local:8123/api/states -H "Authorization: Bearer ..."
可用率 · 30 天窗口
关于这个 API
Home Assistant 是 2013 年开源的智能家居平台，是这个领域的事实开源标准。和 Apple HomeKit / Google Home / Amazon Alexa 这种闭源单厂方案不同，Home Assistant 设计理念是「中立 hub」——它能集成 2500+ 厂商的设备（Philips Hue 灯、米家家电、宜家 Trådfri、Sonos 音箱、Ring 门铃、Tesla 充电、Apple HomeKit 设备、几乎所有 Z-Wave / Zigbee 设备等），把不同协议的设备统一抽象成 entity，然后跑 Python 写的自动化规则（条件触发、定时器、状态机）。本地优先——不依赖云（你家断网设备照常工作），用户家里跑一台 Raspberry Pi 或 NUC 作 server。API 让开发者把 Home Assistant 集成进自己 app 或写自定义脚本。和单一智能家居 brand 的 cloud API 相比，Home Assistant 给"全屋智能"提供了厂商中立的统一接口。
你可以做什么
- 1自建智能家居中枢（不锁定单一品牌）
- 2把 Philips Hue + 米家 + Alexa + Apple HomeKit 等多家设备整合
- 3自定义自动化（"日落自动开灯"）
- 4语音助手集成（NLP 把 "关客厅灯" 转 API）
优劣对比
优点
- 完全开源 (Apache 2.0)
- 设备兼容性最广（2500+ 厂商）
- 本地优先（不依赖云）
- 社区极活跃
注意事项
- 要自己跑 server（Raspberry Pi 或 NUC）
- 上手有学习曲线（不是即开即用的消费产品）
示例请求
curl https://www.home-assistant.io/<endpoint> \
-H "Authorization: Bearer $ACCESS_TOKEN"快速开始
本地起 Home Assistant 实例。Profile → 创建 long-lived access token。GET http://homeassistant.local:8123/api/states -H "Authorization: Bearer ..."
常见问题
Home Assistant 和 Apple HomeKit 关系？+
Home Assistant 能完整集成 HomeKit 设备（甚至 export 自己设备给 HomeKit 看）。两者并不互斥，可以共存。
技术细节
- 认证方式
- jwt
- 计费
- free
- 速率限制
- 本地运行无 rate limit
- 协议
- REST, WebSocket
- SDK
- python, javascript, go