HomeAssist 设置 API 指南

什么是 HomeAssist？

HomeAssist 是一个开源的智能家居自动化平台，允许用户通过 Web API 控制设备、创建自动化规则，并与第三方服务集成。

API 基础配置

要使用 HomeAssist 的 API，首先需要在配置文件中启用 API 组件：

# configuration.yaml

api:

重启 HomeAssist 后，API 将在 /api/ 路径下可用。

认证方式

HomeAssist API 使用长期访问令牌（Long-lived Access Token）进行身份验证。您可以在用户资料页面生成令牌，并在请求头中使用：

Authorization: Bearer YOUR_LONG_LIVED_ACCESS_TOKEN

常用 API 示例

获取所有实体状态

GET /api/states

Headers:

  Authorization: Bearer YOUR_TOKEN

控制开关设备

POST /api/services/switch/turn_on

Headers:

  Authorization: Bearer YOUR_TOKEN

  Content-Type: application/json

Body:

  {"entity_id": "switch.living_room_light"}

常见问题

• API 返回 401 错误？ 请检查访问令牌是否有效且未过期。
• 如何调试 API 请求？ 可使用 curl 或 Postman 工具进行测试。
• 是否支持 HTTPS？ 是的，建议在公网访问时启用 HTTPS 以保障安全。