Home Assistant RESTful Sensor einrichten & Template Fehler beheben – Schritt für Schritt Tutorial

RESTful Sensor in Home Assistant: Was macht das Snippet?

Mit einem RESTful Sensor in Home Assistant kannst du Daten von externen APIs abrufen und als Sensoren in deinem Smart Home nutzen. Das gezeigte Snippet richtet einen REST-Sensor ein, der Informationen von einer Beispiel-API abruft. Die Daten werden dann mithilfe von Template-Sensoren aufbereitet und als eigene Sensoren angezeigt. Das ist besonders praktisch, wenn du externe Informationen (wie Wetterdaten, Social Media-Statistiken oder beliebige API-Daten) in Home Assistant visualisieren oder für Automatisierungen nutzen möchtest.

RESTful Sensor und Template-Sensor: Schritt für Schritt erklärt

Im ersten Schritt wird ein REST-Sensor konfiguriert. Dieser fragt regelmäßig eine API ab (hier: https://dummyjson.com/posts) und speichert ausgewählte Attribute aus der Antwort als Sensor-Attribute. Im Beispiel werden der Titel, der Text, die Anzahl der Views und Reaktionen des ersten Beitrags extrahiert. Das Hauptattribut des Sensors ist der Titel des Beitrags.

Im zweiten Schritt werden Template-Sensoren definiert. Sie greifen auf die Attribute des REST-Sensors zu und stellen sie als eigene Sensoren bereit. So kannst du zum Beispiel den Beitragstext, die Views oder Likes separat anzeigen und für Automatisierungen verwenden.

1# configuration.yaml
2sensor:
3  - platform: rest
4    resource: "https://dummyjson.com/posts"  # Enter the URL of the API here
5    name: "Post Details"
6    json_attributes_path: "$.posts[0]"  # the first post, not the whole list
7    json_attributes:
8      - title
9      - body
10      - views
11    value_template: "{{ value_json.posts[0].title }}"  # the title as the state
12    scan_interval: 300  # Interval for updating in seconds
13
14template:
15  - sensor:
16      - name: "Post Body"
17        state: "{{ (state_attr('sensor.post_details', 'body') or '')[:255] }}"
18      - name: "Post Views"
19        state: "{{ state_attr('sensor.post_details', 'views') }}"

Mit dieser Konfiguration erhältst du einen Sensor sensor.post_details mit Attributen und zwei weitere Sensoren für Body und Views.

Zwei Stellen, an denen es gern hakt: json_attributes_path muss auf ein einzelnes Objekt zeigen. Mit $.posts zeigt er auf die ganze Liste, Home Assistant meldet dann „JSON result was not a dictionary“ und der Sensor bekommt keine Attribute. Und ein Zustand darf höchstens 255 Zeichen lang sein. Deshalb steht im value_template nur der Titel und nicht die ganze Antwort. Der Beitragstext wird im Template-Sensor auf 255 Zeichen gekürzt. Das ist sinnvoll, wenn du die Daten gezielt in Dashboards oder Automatisierungen verwenden möchtest.

RESTful Sensor und Template-Sensor in sensor.yaml auslagern

Für eine übersichtliche Konfiguration empfiehlt es sich, die Sensoren in eine eigene sensor.yaml auszulagern. Das erleichtert die Wartung und hält die configuration.yaml schlank.

So gehst du vor:

• Dateien anlegen oder bearbeiten: Trage den REST-Sensor in deine sensor.yaml ein und die Template-Sensoren in eine eigene template.yaml. Seit 2026.6 dürfen Template-Entitäten nicht mehr unter sensor: stehen, sie brauchen den eigenen template:-Block.
  • REST-Sensor konfigurieren: Passe die API-URL im Feld resource an deine Anwendung an. Die Attribute title, body, views und reactions werden aus dem ersten Beitrag der API-Antwort extrahiert.
  • Template-Sensoren einrichten: Diese Sensoren lesen gezielt Werte aus den Attributen des REST-Sensors aus und stellen sie als eigene Entitäten bereit.
  • Beide Dateien in configuration.yaml einbinden: Füge folgende Einträge in deine configuration.yaml ein, damit Home Assistant die Sensoren lädt:

# configuration.yaml
sensor: !include sensor.yaml
template: !include template.yaml

Speichere die Änderungen und starte Home Assistant neu, damit die neuen Sensoren aktiv werden.

1# sensor.yaml
2- platform: rest
3  resource: "https://dummyjson.com/posts"  # Enter the API URL here
4  name: "Post Details"
5  json_attributes_path: "$.posts[0]"  # the first post, not the whole list
6  json_attributes:
7    - title
8    - body
9    - views
10    - reactions
11  value_template: "{{ value_json.posts[0].title }}"  # the title as the state
12  scan_interval: 300  # Interval for updating in seconds

1# template.yaml
2- sensor:
3    - name: "Post Title"
4      state: "{{ state_attr('sensor.post_details', 'title') }}"
5    - name: "Post Views"
6      state: "{{ state_attr('sensor.post_details', 'views') }}"
7    - name: "Post Likes"
8      state: "{{ (state_attr('sensor.post_details', 'reactions') or {}).get('likes', 0) }}"

Mit dieser Struktur kannst du beliebige API-Daten als Sensoren in Home Assistant nutzen und flexibel weiterverarbeiten. Achte darauf, die API-URL und die gewünschten Attribute an deine eigenen Anforderungen anzupassen.

Hier wird im Video erklärt, wie die Umsetzung von „Home Assistant RESTful Sensor einrichten & Template Fehler beheben – Schritt für Schritt Tutorial“ konkret aussieht.