SuperAPI AI 工具集

ha-core

通用与其它

查看项目

更新于 10-16 05:43

技能介绍

该技能用于在开发中集成 Home Assistant 的 Core API,触发场景包括使用 Home Assistant REST API、WebSocket API 连接、实体状态管理、服务调用、事件总线订阅与认证。

认证采用 Long-Lived Access Token,通过 Authorization: Bearer <token> 请求头传递。REST 客户端示例提供 get_states、get_state、call_service 等方法,分别访问 /api/states、/api/states/{entity_id}、/api/services/{domain}/{service} 端点。同时给出等价的 TypeScript 客户端实现。

WebSocket API 用于实时状态更新:连接 /api/websocket 后先接收 auth_required,再发送 auth 消息与 access_token,收到 auth_ok 表示成功;支持 subscribe_events 订阅事件(如 state_changed)和 subscribe_trigger 按实体订阅状态变化,并通过 listen 迭代接收消息。

技能列出常见实体域及服务:light、switch、climate、cover、lock、media_player、fan、vacuum、camera、sensor(只读)、binary_sensor(只读)。服务调用示例包括灯光的亮度、色温、RGB 与过渡,温控器的温度与预设模式,媒体播放器的播放与音量等。

错误处理示例区分 401 认证失败、404 服务或实体不存在等情况。最佳实践建议使用 area 与 label 分组定位、为网络失败实现重试、缓存实体状态以减少 API 调用、用 WebSocket 做实时监控、调用前校验 entity_id,并优雅处理不可用状态。资料未提供收费、平台限制或其他使用条件的说明。