🏠 Home Assistant Integration

API-Key aus der App holen

Öffne die Sternkids App und navigiere zu:

Elternbereich → Einstellungen → Allgemein → Integrationen

Dort findest du deinen persönlichen API-Key. Kopiere ihn – du benötigst ihn im nächsten Schritt.

REST Sensor in Home Assistant einrichten

Füge folgendes in deine configuration.yaml ein und ersetze DEIN-API-KEY mit dem kopierten Key:

sensor:
  - platform: rest
    name: "Sternkids Familie"
    resource: "https://sternkids.de/api/ha/status?key=DEIN-API-KEY"
    scan_interval: 300
    value_template: "{{ value_json.family }}"
    json_attributes:
      - children
      - week_goal
      - rewards

  - platform: template
    sensors:
      sternkids_kind1_sterne_heute:
        friendly_name: "Kind 1 – Sterne heute"
        value_template: >
          {{ state_attr('sensor.sternkids_familie',
             'children')[0]['stars_today'] }}
        unit_of_measurement: "⭐"

      sternkids_kind1_sterne_woche:
        friendly_name: "Kind 1 – Sterne diese Woche"
        value_template: >
          {{ state_attr('sensor.sternkids_familie',
             'children')[0]['stars_week'] }}
        unit_of_measurement: "⭐"

      sternkids_kind1_aufgaben_heute:
        friendly_name: "Kind 1 – Aufgaben heute"
        value_template: >
          {{ state_attr('sensor.sternkids_familie',
             'children')[0]['tasks_done_today'] }}
             / {{ state_attr('sensor.sternkids_familie',
             'children')[0]['tasks_total_today'] }}

💡 Für weitere Kinder [0] durch [1], [2] usw. ersetzen. Nach der Änderung Home Assistant neu starten.

Dashboard Card erstellen

Füge in deinem Lovelace Dashboard eine neue Card hinzu (YAML-Modus):

type: entities
title: "⭐ Sternkids"
entities:
  - entity: sensor.sternkids_kind1_sterne_heute
    name: "Heute gesammelt"
    icon: mdi:star
  - entity: sensor.sternkids_kind1_sterne_woche
    name: "Diese Woche"
    icon: mdi:star-outline
  - entity: sensor.sternkids_kind1_aufgaben_heute
    name: "Aufgaben heute"
    icon: mdi:checkbox-marked-circle-outline

Automationen einrichten

Beispiel: Benachrichtigung wenn alle Aufgaben erledigt sind.

automation:
  - alias: "Sternkids – Alle Aufgaben erledigt"
    trigger:
      - platform: template
        value_template: >
          {{ state_attr('sensor.sternkids_familie',
             'children')[0]['tasks_done_today'] ==
             state_attr('sensor.sternkids_familie',
             'children')[0]['tasks_total_today'] }}
    condition:
      - condition: template
        value_template: >
          {{ state_attr('sensor.sternkids_familie',
             'children')[0]['tasks_total_today'] | int > 0 }}
    action:
      - service: notify.mobile_app
        data:
          title: "⭐ Sternkids"
          message: "Alle Aufgaben für heute erledigt! 🎉"

  - alias: "Sternkids – Wochenziel erreicht"
    trigger:
      - platform: template
        value_template: >
          {{ state_attr('sensor.sternkids_familie',
             'week_goal')['achieved'] == true }}
    action:
      - service: notify.mobile_app
        data:
          title: "🏆 Sternkids"
          message: "Das Wochenziel wurde erreicht!"

💡 Du kannst auch Lichter steuern, Musik abspielen oder andere Smart-Home-Aktionen auslösen.