Home Assistant: Tankerkönig nach API-Fehlern wiederbeleben

Wenn die Spritpreis-Sensoren der Tankerkönig-Integration in Home Assistant plötzlich auf „nicht verfügbar“ springen oder Fehler wie „Unknown error occurred“ werfen, liegt das meist an kurzzeitigen Serverausfällen der API. Obwohl dein API-Key auf der Webseite aktiv ist, verharrt die Integration oft in einem Fehlerzustand. Mit wenigen Handgriffen synchronisierst du die Daten wieder.

Das brauchst du

• Laufende Home-Assistant-Installation
• Eingerichtete Tankerkönig-Integration
• Deinen persönlichen API-Key von Tankerkönig

1. Server-Erreichbarkeit prüfen

Bevor du Einstellungen änderst, prüfe kurz im Webbrowser, ob die API-Webseite (creativecommons.tankerkoenig.de) erreichbar ist. Wenn die Schnittstelle des Anbieters Schluckauf hat, scheitert jede Anfrage direkt an der Quelle. In diesem Fall hilft oft nur Abwarten, bis die Server wieder Daten liefern.

2. Integration neu laden

Hat sich die API erholt, bemerkt Home Assistant das nicht immer sofort automatisch. Ein manueller Reload stößt die Datenabfrage direkt wieder an.

1. Rufe in Home Assistant die Tankerkönig-Integration auf.
2. Wähle bei der Integration die Option über das Drei-Punkte-Menü.
3. Klicke auf Neu laden.

3. Integration neu konfigurieren

Erscheint nach einem Ausfall der Hinweis, dass die Authentifizierung abgelaufen sei, obwohl der Schlüssel aktiv ist, kann eine Neukonfiguration helfen. Richte die Integration in diesem Fall mit deinem bestehenden API-Key neu ein, um die Verbindung sauber zu initialisieren.

4. System-Neustart ausführen

Reagiert die Komponente nach wie vor blockiert und lassen sich keine neuen Tankstellen suchen, starte das System einmal vollständig neu.

Funktioniert es?

Rufe deine Dashboard-Karten oder die Entitätenliste (eine Entität ist der konkrete Datenpunkt in Home Assistant, hier der Sensor für den Spritpreis) auf. Sobald die Verbindung steht, wechseln die Sensoren von „nicht verfügbar“ wieder auf den aktuellen Kraftstoffpreis.

Wenn es nicht klappt

• Fehler „Unknown error occurred“ bei der Tankstellensuche: Dies tritt meist auf, wenn die Verbindung zum Server während der Suchanfrage abreißt. Warte einige Minuten und wiederhole den Suchvorgang.
• Meldung „Authentifizierung abgelaufen“: Nach einem Serverausfall kann diese irreführende Meldung erscheinen, obwohl der API-Key weiterhin aktiv ist. Fordere nicht direkt einen neuen Schlüssel an, sondern konfiguriere die Integration mit deinem bisherigen Key neu.
• Entitäten bleiben dauerhaft offline: Prüfe in den Home-Assistant-Protokollen, ob der Coordinator Fehlermeldungen von components/tankerkoenig meldet, die auf externe Verbindungsprobleme hindeuten.

Mit den wiederhergestellten Kraftstoffpreisen kannst du Automationen einrichten, die dich über dein Smartphone benachrichtigen, sobald der Benzinpreis an deiner Stammzapfsäule unter einen bestimmten Wert fällt.

Quellen: Forum: Simon42 – Forum, community-smarthome.com, github.com