Fehlerverhalten – Referenz

Situation	Verhalten
Ein Messwert fehlt in der API-Antwort	Nur dieser Sensor wird unknown
Alle Leistungswerte fehlen	UpdateFailed → alle Sensoren unavailable
HTTP 401 / 403 / Token abgelaufen	ConfigEntryAuthFailed → Reauth-Flow startet automatisch
Timeout / DNS-Fehler / HTTP 5xx	UpdateFailed → alle Sensoren unavailable
Rate Limit (HTTP 429)	UpdateFailed → unavailable, nächster Versuch im Polling-Intervall
Demo-Modus	Simulierte Werte, Quelle demo
Ungültige Zugangsdaten	Kein Fallback auf Demo — Sensoren bleiben unavailable

Kein „Last Known Value"-Fallback

Veraltete Werte, die als aktuell angezeigt werden, sind für Automatisierungen gefährlicher als ein sichtbares unavailable. Deshalb gibt es keinen Fallback auf den letzten bekannten Wert.

Reauth-Flow

Bei ConfigEntryAuthFailed zeigt HA automatisch ein Banner „Re-Authentifizierung erforderlich". Wie die Reauth durchgeführt wird: reauth.md.