Apple Health-Daten mit Home Assistant synchronisieren

Integrieren Sie Ihre Gesundheitsdaten mit Home Assistant.

Last updated: February 5, 2026

On this page

Home Assistant-Automatisierungen ermöglichen es Ihnen, Ihre Gesundheitsdaten automatisch mit Home Assistant als Sensorzustände zu synchronisieren. Diese Integration ermöglicht es Ihnen, Ihre Gesundheitsdaten in Home Assistant-Automatisierungen, Dashboards und anderen Integrationen zu verwenden.

Übersicht

Home Assistant-Automatisierungen senden Ihre Gesundheitsmetriken an die REST-API von Home Assistant und erstellen oder aktualisieren Sensorzustände, die in Ihrer gesamten Home Assistant-Instanz verwendet werden können. Die Daten sind speziell für die /states/-API von Home Assistant formatiert.

Anwendungsfälle:

Gesundheitsmetriken auf Home Assistant-Dashboards anzeigen
Automatisierungen basierend auf Gesundheitsdaten erstellen
Gesundheitsdaten mit anderen Smart-Home-Geräten integrieren
Gesundheitstrends über die Zeit in Home Assistant verfolgen

Hauptfunktionen:

Automatische Sensorzustandserstellung
Nur JSON-Format (optimiert für Home Assistant)
Nur Health Metrics-Datentyp
Einfache URL-Konfiguration

Einschränkungen

Zugriff auf Gesundheitsdaten: Apps dürfen nicht auf Gesundheitsdaten zugreifen, während das iPhone gesperrt ist. Automatisierungen werden nur während der Zeiträume ausgeführt, in denen Ihr Gerät entsperrt ist. Dies kann die Aktualität der Daten beeinträchtigen. Siehe Anweisungen für manuelle Synchronisierung, um Daten aktuell zu halten.
Hintergrundverarbeitung: iOS begrenzt die Hintergrundverarbeitung, um die Batterielebensdauer zu erhalten. Automatisierungen sind auf Hintergrundaktualisierung der App angewiesen und werden möglicherweise nicht sofort ausgeführt, wenn:
- Hintergrundaktualisierung der App für die App deaktiviert ist
- Das Gerät im Energiesparmodus ist
- Das Gerät über längere Zeiträume inaktiv war
- Systemressourcen eingeschränkt sind
- Mehrere Apps um Ausführungszeit im Hintergrund konkurrieren
Unterstützt nur Health Metrics-Datentyp
Nur JSON-Format (kann nicht geändert werden)

Voraussetzungen

Eine laufende und in Ihrem Netzwerk zugängliche Home Assistant-Instanz
Home Assistant API-Zugriffstoken (Langzeit-Zugriffstoken)
Netzwerkverbindung zu Ihrer Home Assistant-Instanz
Home Assistant-Version, die REST-API unterstützt

Konfiguration

Navigieren Sie zum Bildschirm "Automatisierte Exporte" aus der Hauptnavigation, tippen Sie dann auf "Neue Automatisierung" und wählen Sie "Home Assistant" als Automatisierungstyp.

Automatisierungsname

Geben Sie einen beschreibenden Namen für Ihre Automatisierung ein. Dieser Name wird verwendet, um die Sensor-Entity-ID in Home Assistant zu generieren.

Hinweis: Der Automatisierungsname wird in Kleinbuchstaben mit entfernten Leerzeichen konvertiert, um die Entity-ID zu erstellen. Zum Beispiel wird "Meine Gesundheitsdaten" zu hae.meinegesundheitsdaten.

Benachrichtigungen

Konfigurieren Sie, wann Sie Benachrichtigungen erhalten möchten:

Bei Cache-Aktualisierung benachrichtigen - Erhalten Sie eine Benachrichtigung, wenn zwischengespeicherte Daten aktualisiert werden
Bei Ausführung benachrichtigen - Erhalten Sie eine Benachrichtigung bei jeder Ausführung der Automatisierung

Home Assistant-URL

Geben Sie die Basis-URL Ihrer Home Assistant-Instanz ein. Dies sollte das Protokoll und den Port enthalten, wenn Sie nicht den Standard verwenden.

Beispiel-URLs:

http://homeassistant.local:8123
http://192.168.1.100:8123

Hinweis: Die URL muss von Ihrem Gerät aus zugänglich sein. Wenn Sie HTTPS verwenden, stellen Sie sicher, dass Ihr Zertifikat gültig ist oder fügen Sie eine Ausnahme hinzu.

Automatisch generierter Endpunkt

Die App generiert automatisch den vollständigen API-Endpunkt basierend auf Ihrem Automatisierungsnamen:

{your_url}/api/states/hae.{automation_name}

Zum Beispiel, wenn Ihre URL http://homeassistant.local:8123 ist und Ihr Automatisierungsname "Gesundheitsmetriken" ist, wird der Endpunkt sein:

http://homeassistant.local:8123/api/states/hae.gesundheitsmetriken

Dieser Endpunkt wird unter dem URL-Feld als Referenz angezeigt.

Anforderungs-Timeout

Wählen Sie ein Timeout-Intervall für HTTP-Anforderungen an Home Assistant.

Verfügbare Timeout-Optionen:

60 Sekunden - Standard, geeignet für die meisten Home Assistant-Instanzen
300 Sekunden (5 Minuten) - Für langsamere Home Assistant-Instanzen
1800 Sekunden (30 Minuten) - Für sehr langsame Verarbeitung
3600 Sekunden (1 Stunde) - Maximal empfohlenes Timeout

HTTP-Header

Fügen Sie Authentifizierungsheader für den Zugriff auf die Home Assistant-API hinzu. Sie müssen einen Authorization-Header mit Ihrem Langzeit-Zugriffstoken hinzufügen.

Erforderlicher Header:

Authorization: Bearer YOUR_LONG_LIVED_ACCESS_TOKEN

So erhalten Sie ein Langzeit-Zugriffstoken:

Öffnen Sie Home Assistant
Gehen Sie zu Ihrem Profil (klicken Sie auf Ihren Namen unten links)
Scrollen Sie nach unten zu "Langzeit-Zugriffstoken"
Klicken Sie auf "Token erstellen"
Geben Sie ihm einen Namen (z. B. "Health Auto Export")
Kopieren Sie das Token und fügen Sie es in das Header-Wertfeld ein

Optionale Header:
Sie können zusätzliche Header hinzufügen, wenn dies für Ihre Home Assistant-Einrichtung erforderlich ist.

So fügen Sie Header hinzu:

Tippen Sie auf "Header hinzufügen"
Geben Sie den Header-Schlüssel in das linke Feld ein
Geben Sie den Header-Wert in das rechte Feld ein
Wiederholen Sie für zusätzliche Header

Wichtig: Jeder Header-Schlüssel muss einen entsprechenden Wert haben. Leere Header werden ignoriert.

Datentyp-Einstellungen

Datentyp

Hinweis: Home Assistant-Automatisierungen unterstützen nur den Health Metrics-Datentyp. Diese Einstellung kann nicht geändert werden und ist automatisch auf Health Metrics gesetzt.

Health Metrics-Konfiguration

Health Metrics auswählen - Wählen Sie, welche spezifischen Metriken einbezogen werden sollen. Sie können alle verfügbaren Metriken auswählen oder spezifische auswählen.

Tipp: Die Auswahl nur der benötigten Metriken kann die Verarbeitungszeit verbessern und die an Home Assistant gesendete Datengröße reduzieren.

Bevorzugte Quellen - Konfigurieren Sie, welche Datenquellen Priorität haben, wenn mehrere Quellen dieselbe Metrik bereitstellen.

Exporteinstellungen

Exportformat

Hinweis: Home Assistant-Automatisierungen unterstützen nur das JSON-Format. Diese Einstellung kann nicht geändert werden und ist automatisch auf JSON gesetzt.

Exportversion

Hinweis: Die Exportversion ist für Home Assistant-Automatisierungen nicht verfügbar, da das Format speziell für die State-API von Home Assistant optimiert ist.

Datumsbereich

Wählen Sie, wann Daten exportiert werden sollen:

Standard - Synchronisiert Daten für den vollständigen vorherigen Tag plus Daten bis zum aktuellen Datum und der aktuellen Uhrzeit
Heute - Synchronisiert alle Daten für das aktuelle Datum bis zur aktuellen Uhrzeit
Gestern - Synchronisiert alle Daten für den vollständigen vorherigen Tag

Hinweis: Home Assistant-Automatisierungen unterstützen die Optionen "Echtzeit", "Seit letzter Synchronisierung" oder "Letzte 7 Tage" nicht.

Daten zusammenfassen

Schalten Sie Daten zusammenfassen EIN oder AUS für Health Metrics.

EIN - Bietet aggregierte Datenzusammenfassungen (Standard)
AUS - Bietet disaggregierte Daten, wenn möglich

Hinweis: Diese Einstellung gilt nur für den Health Metrics-Datentyp.

Zeitgruppierung

Wenn Daten zusammenfassen aktiviert ist, wählen Sie, wie Daten aggregiert werden sollen:

Standard - Keine Aggregation, Rohdatenpunkte
Tage - Gruppiert Daten nach Tagen (empfohlen)

Synchronisierungsfrequenz

Konfigurieren Sie, wie oft die Automatisierung Daten mit Home Assistant synchronisieren soll:

Wählen Sie eine Zahl und ein Intervall.

Tests und Überprüfung

Manuelle Tests

Tippen Sie auf "Manueller Export" im Automatisierungskonfigurationsbildschirm
Wählen Sie einen Datumsbereich
Tippen Sie auf "Exportieren", um eine Testanforderung zu senden
Überprüfen Sie in Home Assistant, ob der Sensorzustand erstellt/aktualisiert wurde

Überprüfung in Home Assistant

Öffnen Sie Home Assistant
Gehen Sie zu Entwicklertools > Zustände
Suchen Sie nach hae.{your_automation_name} (Kleinbuchstaben, keine Leerzeichen)
Überprüfen Sie, ob der Sensorzustand Ihre Gesundheitsdaten anzeigt
Überprüfen Sie den "Zuletzt aktualisiert"-Zeitstempel, um kürzliche Synchronisierungen zu bestätigen

Aktivitätsprotokolle anzeigen

Tippen Sie auf "Aktivitätsprotokolle anzeigen" im Automatisierungskonfigurationsbildschirm
Überprüfen Sie kürzliche Automatisierungsausführungen
Überprüfen Sie auf Fehler oder Warnungen
Überprüfen Sie Anforderungszeitstempel und Antwortstatus

Home Assistant-Protokolle überprüfen

Wenn Daten nicht in Home Assistant erscheinen:

Öffnen Sie Home Assistant
Gehen Sie zu Einstellungen > System > Protokolle
Suchen Sie nach Fehlern im Zusammenhang mit der REST-API oder Sensorzuständen
Überprüfen Sie auf Authentifizierungsfehler oder ungültiges Datenformat

Fehlerbehebung

Häufige Probleme

Authentifizierungsfehler

Überprüfen Sie, ob Ihr Langzeit-Zugriffstoken korrekt ist
Stellen Sie sicher, dass der Authorization-Header formatiert ist als: Bearer YOUR_TOKEN
Überprüfen Sie, ob das Token nicht abgelaufen oder widerrufen wurde
Überprüfen Sie, ob das Token entsprechende Berechtigungen in Home Assistant hat

Sensor erscheint nicht in Home Assistant

Überprüfen Sie, ob der Automatisierungsname keine Sonderzeichen enthält
Überprüfen Sie das Entity-ID-Format: hae.{automation_name} (Kleinbuchstaben, keine Leerzeichen)
Überprüfen Sie Home Assistant-Protokolle auf Fehler
Stellen Sie sicher, dass die API-Anforderung erfolgreich war (überprüfen Sie Aktivitätsprotokolle)

Daten werden nicht aktualisiert

Überprüfen Sie, ob die Automatisierung aktiviert ist
Überprüfen Sie Aktivitätsprotokolle auf Fehler
Stellen Sie sicher, dass die Netzwerkverbindung zu Home Assistant besteht

Verbindungs-Timeout

Überprüfen Sie, ob Home Assistant läuft und zugänglich ist
Überprüfen Sie die Netzwerkverbindung
Erhöhen Sie die Einstellung Anforderungs-Timeout, wenn Home Assistant langsam reagiert
Überprüfen Sie, ob URL und Port korrekt sind

Fehlermeldungen

Die App zeigt Fehlermeldungen an, wenn:

Die URL ungültig oder nicht erreichbar ist
Die Authentifizierung fehlschlägt (überprüfen Sie den Authorization-Header)
Home Assistant einen Fehlerstatuscode zurückgibt
Die Netzwerkverbindung nicht verfügbar ist

Überprüfen Sie die Aktivitätsprotokolle für detaillierte Fehlerinformationen, einschließlich HTTP-Statuscodes und Fehlermeldungen von Home Assistant.

Home Assistant-Integrations-Tipps

Gesundheitsdaten in Automatisierungen verwenden

Sobald Ihre Gesundheitsdaten mit Home Assistant synchronisiert sind, können Sie sie in Automatisierungen verwenden:

automation:
  - alias: "Gute Schlafqualität"
    trigger:
      - platform: numeric_state
        entity_id: sensor.hae_myhealthdata_sleep_total
        above: 7
    action:
      - service: notify.mobile_app_your_phone
        data:
          message: "Großartiger Schlaf letzte Nacht!"

Dashboards erstellen

Fügen Sie Gesundheitsmetriken zu Ihrem Home Assistant-Dashboard hinzu:

Gehen Sie zu Ihrem Dashboard
Fügen Sie eine neue Karte hinzu
Wählen Sie den Kartentyp "Entitäten" oder "Gauge"
Fügen Sie die Sensor-Entitäten hae.{your_automation_name} hinzu

Sensorzustandsstruktur

Der Sensorzustand in Home Assistant enthält:

state: Der aktuelle Wert oder Status
attributes: Zusätzliche Daten einschließlich:
- Zeitstempelinformationen
- Datenstruktur, die dem exportierten JSON-Format entspricht
- Einheitsinformationen, falls zutreffend

Tipps und Best Practices

Benennung:
- Vermeiden Sie Sonderzeichen, die Probleme verursachen könnten
Datenauswahl:
- Wählen Sie nur die Metriken aus, die Sie benötigen