Apple Health-gegevens synchroniseren met Home Assistant

Home Assistant-automatiseringen stellen u in staat om uw gezondheidsgegevens automatisch te synchroniseren met Home Assistant als sensorstatussen. Deze integratie stelt u in staat om uw gezondheidsgegevens te gebruiken in Home Assistant-automatiseringen, dashboards en andere integraties.

Overzicht

Home Assistant-automatiseringen sturen uw gezondheidsmetrieken naar de REST API van Home Assistant, waardoor sensorstatussen worden gemaakt of bijgewerkt die kunnen worden gebruikt in uw hele Home Assistant-instantie. De gegevens zijn specifiek geformatteerd voor de /states/ API van Home Assistant.

Gebruikssituaties:

• Gezondheidsmetrieken weergeven op Home Assistant-dashboards
• Automatiseringen maken op basis van gezondheidsgegevens
• Gezondheidsgegevens integreren met andere slimme huisapparaten
• Gezondheidstrends in de loop van de tijd volgen in Home Assistant

Belangrijkste functies:

• Automatische sensorstatusaanmaak
• Alleen JSON-formaat (geoptimaliseerd voor Home Assistant)
• Alleen Health Metrics-gegevenstype
• Eenvoudige URL-configuratie

Beperkingen

• Toegang tot gezondheidsgegevens: Apps mogen geen toegang hebben tot gezondheidsgegevens terwijl de iPhone vergrendeld is. Automatiseringen worden alleen uitgevoerd tijdens perioden waarin uw apparaat ontgrendeld is. Dit kan de actualiteit van de gegevens beïnvloeden. Zie instructies voor handmatige synchronisatie om gegevens up-to-date te houden.

• Achtergrondverwerking: iOS beperkt achtergrondverwerking om de batterijduur te behouden. Automatiseringen zijn afhankelijk van App-achtergrondverversing en worden mogelijk niet onmiddellijk uitgevoerd als:

  • App-achtergrondverversing is uitgeschakeld voor de app
  • Het apparaat in de energiebesparende modus is
  • Het apparaat gedurende langere perioden inactief is geweest
  • Systeembronnen beperkt zijn
  • Meerdere apps concurreren om achtergronduitvoeringstijd

• Ondersteunt alleen Health Metrics-gegevenstype

• Alleen JSON-formaat (kan niet worden gewijzigd)

Vereisten

• Een Home Assistant-instantie die draait en toegankelijk is op uw netwerk
• Home Assistant API-toegangstoken (Langlevend toegangstoken)
• Netwerkverbinding met uw Home Assistant-instantie
• Home Assistant-versie die REST API ondersteunt

Configuratie

Navigeer naar het scherm Geautomatiseerde exports vanuit de hoofdnavigatie, tik vervolgens op "Nieuwe automatisering" en selecteer "Home Assistant" als het Automatiseringstype.

Automatiseringsnaam

Voer een beschrijvende naam in voor uw automatisering. Deze naam wordt gebruikt om de sensor-entiteit-ID in Home Assistant te genereren.

Opmerking: De automatiseringsnaam wordt geconverteerd naar kleine letters met verwijderde spaties om de entiteit-ID te maken. Bijvoorbeeld, "Mijn gezondheidsgegevens" wordt hae.mijngezondheidsgegevens.

Meldingen

Configureer wanneer u meldingen wilt ontvangen:

• Melden bij cache-update - Ontvang een melding wanneer gecachte gegevens worden bijgewerkt
• Melden bij uitvoering - Ontvang een melding telkens wanneer de automatisering wordt uitgevoerd

Home Assistant-URL

Voer de basis-URL van uw Home Assistant-instantie in. Dit moet het protocol en de poort bevatten als u niet de standaard gebruikt.

Voorbeeld-URL's:

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

Opmerking: De URL moet toegankelijk zijn vanaf uw apparaat. Als u HTTPS gebruikt, zorg ervoor dat uw certificaat geldig is of voeg een uitzondering toe.

Automatisch gegenereerd eindpunt

De app genereert automatisch het volledige API-eindpunt op basis van uw automatiseringsnaam:

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

Bijvoorbeeld, als uw URL http://homeassistant.local:8123 is en uw automatiseringsnaam "Gezondheidsmetrieken" is, is het eindpunt:

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

Dit eindpunt wordt onder het URL-veld weergegeven als referentie.

Verzoektime-out

Selecteer een time-outinterval voor HTTP-verzoeken aan Home Assistant.

Beschikbare time-outopties:

• 60 seconden - Standaard, geschikt voor de meeste Home Assistant-instanties
• 300 seconden (5 minuten) - Voor langzamere Home Assistant-instanties
• 1800 seconden (30 minuten) - Voor zeer trage verwerking
• 3600 seconden (1 uur) - Maximale aanbevolen time-out

HTTP-headers

Voeg authenticatieheaders toe voor toegang tot de Home Assistant API. U moet een Authorization-header toevoegen met uw Langlevend toegangstoken.

Vereiste header:

• Authorization: Bearer YOUR_LONG_LIVED_ACCESS_TOKEN

Om een Langlevend toegangstoken te krijgen:

1. Open Home Assistant
2. Ga naar uw profiel (klik op uw naam linksonder)
3. Scroll naar beneden naar "Langlevende toegangstokens"
4. Klik op "Token maken"
5. Geef het een naam (bijvoorbeeld "Health Auto Export")
6. Kopieer het token en plak het in het headerwaardeveld

Optionele headers:
U kunt aanvullende headers toevoegen indien nodig voor uw Home Assistant-installatie.

Om headers toe te voegen:

1. Tik op "Headers toevoegen"
2. Voer de headersleutel in het linkerveld in
3. Voer de headerwaarde in het rechterveld in
4. Herhaal voor aanvullende headers

Belangrijk: Elke headersleutel moet een corresponderende waarde hebben. Lege headers worden genegeerd.

Gegevenstype-instellingen

Gegevenstype

Opmerking: Home Assistant-automatiseringen ondersteunen alleen het Health Metrics-gegevenstype. Deze instelling kan niet worden gewijzigd en wordt automatisch ingesteld op Health Metrics.

Health Metrics-configuratie

Selecteer Health Metrics - Kies welke specifieke metrieken u wilt opnemen. U kunt alle beschikbare metrieken selecteren of specifieke kiezen.

Tip: Alleen de metrieken selecteren die u nodig heeft, kan de verwerkingstijd verbeteren en de gegevensgrootte die naar Home Assistant wordt verzonden verminderen.

Voorkeursbronnen - Configureer welke gegevensbronnen prioriteit hebben wanneer meerdere bronnen dezelfde metriek leveren.

Exportinstellingen

Exportformaat

Opmerking: Home Assistant-automatiseringen ondersteunen alleen JSON-formaat. Deze instelling kan niet worden gewijzigd en wordt automatisch ingesteld op JSON.

Exportversie

Opmerking: Exportversie is niet beschikbaar voor Home Assistant-automatiseringen omdat het formaat specifiek is geoptimaliseerd voor de state API van Home Assistant.

Datumbereik

Selecteer wanneer gegevens moeten worden geëxporteerd:

• Standaard - Synchroniseert gegevens voor de volledige vorige dag plus gegevens tot de huidige datum en tijd
• Vandaag - Synchroniseert alle gegevens voor de huidige datum tot het huidige tijdstip
• Gisteren - Synchroniseert alle gegevens voor de volledige vorige dag

Opmerking: Home Assistant-automatiseringen ondersteunen de opties "Realtime", "Sinds laatste synchronisatie" of "Vorige 7 dagen" niet.

Gegevens samenvatten

Schakel Gegevens samenvatten AAN of UIT voor Health Metrics.

• AAN - Biedt geaggregeerde gegevenssamenvattingen (standaard)
• UIT - Biedt gedisaggregeerde gegevens waar mogelijk

Opmerking: Deze instelling is alleen van toepassing op het Health Metrics-gegevenstype.

Tijdsgroepering

Wanneer Gegevens samenvatten is ingeschakeld, selecteer hoe gegevens moeten worden geaggregeerd:

• Standaard - Geen aggregatie, ruwe gegevenspunten
• Dagen - Groepeert gegevens per dag (aanbevolen)

Synchronisatiefrequentie

Configureer hoe vaak de automatisering gegevens moet synchroniseren met Home Assistant:

Selecteer een nummer en interval.

Testen en verifiëren

Handmatige tests

1. Tik op "Handmatige export" in het automatiseringsconfiguratiescherm
2. Selecteer een datumbereik
3. Tik op "Exporteren" om een testverzoek te verzenden
4. Controleer in Home Assistant of de sensorstatus is gemaakt/bijgewerkt

Verifiëren in Home Assistant

1. Open Home Assistant
2. Ga naar Ontwikkelaarshulpmiddelen > Statussen
3. Zoek naar hae.{your_automation_name} (kleine letters, geen spaties)
4. Verifieer dat de sensorstatus uw gezondheidsgegevens weergeeft
5. Controleer de "Laatst bijgewerkt"-tijdstempel om recente synchronisaties te bevestigen

Activiteitenlogboeken bekijken

1. Tik op "Activiteitenlogboeken bekijken" in het automatiseringsconfiguratiescherm
2. Bekijk recente automatiseringsuitvoeringen
3. Controleer op fouten of waarschuwingen
4. Verifieer verzoektijdstempels en responsstatus

Home Assistant-logboeken controleren

Als gegevens niet verschijnen in Home Assistant:

1. Open Home Assistant
2. Ga naar Instellingen > Systeem > Logboeken
3. Zoek naar fouten gerelateerd aan de REST API of sensorstatussen
4. Controleer op authenticatiefouten of ongeldig gegevensformaat

Problemen oplossen

Veelvoorkomende problemen

Authenticatiefouten

• Verifieer dat uw Langlevend toegangstoken correct is
• Zorg ervoor dat de Authorization-header is geformatteerd als: Bearer YOUR_TOKEN
• Controleer of het token niet is verlopen of ingetrokken
• Verifieer dat het token de juiste machtigingen heeft in Home Assistant

Sensor verschijnt niet in Home Assistant

• Controleer of de automatiseringsnaam geen speciale tekens bevat
• Verifieer het entiteit-ID-formaat: hae.{automation_name} (kleine letters, geen spaties)
• Controleer Home Assistant-logboeken op fouten
• Zorg ervoor dat het API-verzoek succesvol was (controleer Activiteitenlogboeken)

Gegevens worden niet bijgewerkt

• Controleer of de automatisering is ingeschakeld
• Bekijk Activiteitenlogboeken op fouten
• Zorg voor netwerkverbinding met Home Assistant

Verbindingstime-out

• Verifieer dat Home Assistant draait en toegankelijk is
• Controleer de netwerkverbinding
• Verhoog de instelling Verzoektime-out als Home Assistant langzaam reageert
• Verifieer dat de URL en poort correct zijn

Foutmeldingen

De app geeft foutmeldingen weer als:

• De URL ongeldig of onbereikbaar is
• Authenticatie mislukt (controleer de Authorization-header)
• Home Assistant een foutstatuscode retourneert
• Netwerkverbinding niet beschikbaar is

Controleer de Activiteitenlogboeken voor gedetailleerde foutinformatie, inclusief HTTP-statuscodes en foutmeldingen van Home Assistant.

Home Assistant-integratietips

Gezondheidsgegevens gebruiken in automatiseringen

Zodra uw gezondheidsgegevens zijn gesynchroniseerd met Home Assistant, kunt u ze gebruiken in automatiseringen:

automation:
  - alias: "Goede slaapkwaliteit"
    trigger:
      - platform: numeric_state
        entity_id: sensor.hae_myhealthdata_sleep_total
        above: 7
    action:
      - service: notify.mobile_app_your_phone
        data:
          message: "Geweldige slaap gisteravond!"

Dashboards maken

Voeg gezondheidsmetrieken toe aan uw Home Assistant-dashboard:

1. Ga naar uw dashboard
2. Voeg een nieuwe kaart toe
3. Selecteer het kaarttype "Entiteiten" of "Gauge"
4. Voeg de sensor-entiteiten hae.{your_automation_name} toe

Sensorstatusstructuur

De sensorstatus in Home Assistant bevat:

• state: De huidige waarde of status
• attributes: Aanvullende gegevens inclusief:
  • Tijdstempelinformatie
  • Gegevensstructuur die overeenkomt met het geëxporteerde JSON-formaat
  • Eenheidsinformatie waar van toepassing

Tips en best practices

1. Naamgeving:

   • Vermijd speciale tekens die problemen kunnen veroorzaken

2. Gegevensselectie:

   • Selecteer alleen de metrieken die u nodig heeft