用途:这是一个 Home Assistant 的参考型技能,用于把外部 API 和服务接入 Home Assistant。
覆盖范围:按类别整理了多个 API,包括能源与电力(Tibber、Nordpool、Energi Data Service)、天气(SMHI、OpenWeatherMap、yr.no、Tomorrow.io)、交通(SL、Trafikverket、Resrobot、Entur)、智能家居云(Shelly Cloud、Tuya IoT、Philips Hue、IKEA Dirigera)、通用类(OpenAI、Spotify、Google Calendar、Telegram、GitHub)。
主要能力:提供认证模式速查(请求头 API key、URL 参数、OAuth2、本地按键令牌、无认证、Basic Auth),并针对每个 API 生成对应接入方法的工作代码。
三种接入方式:Node-RED 的 HTTP 请求节点与函数节点流程;HA YAML 的 rest sensor 与 rest_command;以及可用 HACS 发布的完整 Python 自定义集成(配合 ha-integration 技能)。示例包括带 Authorization 头的 HTTP 请求、Tibber 风格的 GraphQL POST,以及 rest sensor 的 scan_interval、resource、headers、value_template 配置。
使用方式:用户提到某个 API 或服务名称后,读取对应参考文件,按其选择的接入方式生成可用代码,并附上凭据配置说明与错误处理建议。
限制与安全要求:凭据必须放在 Node-RED 凭据、ESPHome secrets.yaml 或 HA secrets.yaml 中,绝不硬编码进流程或 YAML,也不要把真实令牌粘贴到聊天、可导出的流程或提交到 git 的 YAML。需遵守 API 速率限制,设置 scan_interval 或流程定时器;OAuth2 需说明刷新令牌流程。未提供的功能、收费、价格与平台细节以资料为准。