api-catalog

# API Catalog for Home Assistant Reference skill for connecting external APIs and services to Home Assistant. ## Overview This skill covers authentication patterns and working code examples for connecting popular APIs to Home Assistant via three methods: - **Node-RED** - HTTP request node flows (fastest to get running) - **HA YAML** - `rest` sensor and `rest_command` (good for simple polling) - **Custom integration** - Full HACS-publishable Python component (use `ha-integration` skill) ## The Iron Law ``` CREDENTIALS IN SECRETS - NEVER HARDCODED IN FLOWS OR YAML ``` API keys belong in Node-RED credentials, ESPHome secrets.yaml, or HA `secrets.yaml`. Never paste real tokens into chat, flows that get exported, or YAML committed to git. ## How to Use This Skill 1. User mentions an API or service by name 2. Read the relevant reference file for auth setup and endpoints 3. Generate working code for the user's chosen method (Node-RED / YAML / integration) 4. Include credential setup instructions ## Reference Files | Category | File | APIs Covered | |----------|------|-------------| | Energy & electricity | `references/energy-apis.md` | Tibber, Nordpool, Energi Data Service | | Weather | `references/weather-apis.md` | SMHI, OpenWeatherMap, yr.no, Tomorrow.io | | Transport | `references/transport-apis.md` | SL, Trafikverket, Resrobot, Entur (NO) | | Smart home clouds | `references/smarthome-apis.md` | Shelly Cloud, Tuya IoT, Philips Hue, IKEA Dirigera | | Global / other | `...