Synkronisera Apple Health-data med Home Assistant

Home Assistant-automatiseringar gör att du kan automatiskt synkronisera dina hälsodata med Home Assistant som sensorstatusar. Denna integration gör att du kan använda dina hälsodata i Home Assistant-automatiseringar, instrumentpaneler och andra integrationer.

Översikt

Home Assistant-automatiseringar skickar dina hälsomätvärden till Home Assistants REST API, skapar eller uppdaterar sensorstatusar som kan användas i hela din Home Assistant-instans. Data är formaterade specifikt för Home Assistants /states/ API.

Användningsfall:

• Visa hälsomätvärden på Home Assistant-instrumentpaneler
• Skapa automatiseringar baserade på hälsodata
• Integrera hälsodata med andra smarta hem-enheter
• Spåra hälsotrender över tid i Home Assistant

Nyckelfunktioner:

• Automatisk skapande av sensorstatus
• Endast JSON-format (optimerat för Home Assistant)
• Endast Health Metrics-datatyp
• Enkel URL-konfiguration

Begränsningar

• Åtkomst till hälsodata: Appar får inte komma åt hälsodata medan iPhone är låst. Automatiseringar körs endast under perioder när din enhet är upplåst. Detta kan påverka dataaktualiteten. Se instruktioner för manuell synkronisering för att hålla data uppdaterade.

• Bakgrundsbehandling: iOS begränsar bakgrundsbehandling för att bevara batterilevenslängden. Automatiseringar är beroende av App-uppdatering i bakgrunden och kanske inte körs omedelbart om:

  • App-uppdatering i bakgrunden är inaktiverad för appen
  • Enheten är i Energisparläge
  • Enheten har varit inaktiv under längre perioder
  • Systemresurser är begränsade
  • Flera appar konkurrerar om bakgrundskörningstid

• Stöder endast Health Metrics-datatyp

• Endast JSON-format (kan inte ändras)

Förutsättningar

• En Home Assistant-instans som körs och är tillgänglig på ditt nätverk
• Home Assistant API-åtkomsttoken (Långlivad åtkomsttoken)
• Nätverksanslutning till din Home Assistant-instans
• Home Assistant-version som stöder REST API

Konfiguration

Navigera till skärmen Automatiserade export från huvudnavigeringen, tryck sedan på "Ny automatisering" och välj "Home Assistant" som Automatiserings typ.

Automatiseringsnamn

Ange ett beskrivande namn för din automatisering. Detta namn kommer att användas för att generera sensor-entitets-ID:t i Home Assistant.

Obs: Automatiseringsnamnet kommer att konverteras till gemener med borttagna mellanslag för att skapa entitets-ID:t. Till exempel blir "Mina hälsodata" till hae.minahalsodata.

Notifikationer

Konfigurera när du vill ta emot notifikationer:

• Meddela vid cacheuppdatering - Ta emot en notifikation när cachade data uppdateras
• Meddela vid körning - Ta emot en notifikation varje gång automatiseringen körs

Home Assistant-URL

Ange bas-URL:en för din Home Assistant-instans. Detta bör inkludera protokollet och porten om du inte använder standarden.

Exempel-URL:er:

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

Obs: URL:en måste vara tillgänglig från din enhet. Om du använder HTTPS, se till att ditt certifikat är giltigt eller lägg till ett undantag.

Automatiskt genererad slutpunkt

Appen genererar automatiskt den fullständiga API-slutpunkten baserat på ditt automatiseringsnamn:

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

Till exempel, om din URL är http://homeassistant.local:8123 och ditt automatiseringsnamn är "Hälsomätvärden", blir slutpunkten:

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

Denna slutpunkt visas under URL-fältet som referens.

Begäranstimeout

Välj ett timeout-intervall för HTTP-begäranden till Home Assistant.

Tillgängliga timeout-alternativ:

• 60 sekunder - Standard, lämpligt för de flesta Home Assistant-instanser
• 300 sekunder (5 minuter) - För långsammare Home Assistant-instanser
• 1800 sekunder (30 minuter) - För mycket långsam bearbetning
• 3600 sekunder (1 timme) - Maximal rekommenderad timeout

HTTP-huvuden

Lägg till autentiseringshuvuden för åtkomst till Home Assistant API. Du behöver lägga till ett Authorization-huvud med din Långlivade åtkomsttoken.

Obligatoriskt huvud:

• Authorization: Bearer YOUR_LONG_LIVED_ACCESS_TOKEN

För att få en Långlivad åtkomsttoken:

1. Öppna Home Assistant
2. Gå till din profil (klicka på ditt namn längst ner till vänster)
3. Scrolla ner till "Långlivade åtkomsttokens"
4. Klicka på "Skapa token"
5. Ge den ett namn (t.ex. "Health Auto Export")
6. Kopiera tokenen och klistra in den i huvudvärdefältet

Valfria huvuden:
Du kan lägga till ytterligare huvuden om det behövs för din Home Assistant-inställning.

För att lägga till huvuden:

1. Tryck på "Lägg till huvuden"
2. Ange huvudnyckeln i vänster fält
3. Ange huvudvärdet i höger fält
4. Upprepa för ytterligare huvuden

Viktigt: Varje huvudnyckel måste ha ett motsvarande värde. Tomma huvuden ignoreras.

Datatypinställningar

Datatyp

Obs: Home Assistant-automatiseringar stöder endast Health Metrics-datatyp. Denna inställning kan inte ändras och sätts automatiskt till Health Metrics.

Health Metrics-konfiguration

Välj Health Metrics - Välj vilka specifika mätvärden som ska inkluderas. Du kan välja alla tillgängliga mätvärden eller välja specifika.

Tips: Att välja endast de mätvärden du behöver kan förbättra bearbetningstiden och minska datastorleken som skickas till Home Assistant.

Föredragna källor - Konfigurera vilka datakällor som har prioritet när flera källor tillhandahåller samma mätvärde.

Exportinställningar

Exportformat

Obs: Home Assistant-automatiseringar stöder endast JSON-format. Denna inställning kan inte ändras och sätts automatiskt till JSON.

Exportversion

Obs: Exportversion är inte tillgänglig för Home Assistant-automatiseringar eftersom formatet är optimerat specifikt för Home Assistants state API.

Datumintervall

Välj när data ska exporteras:

• Standard - Synkroniserar data för hela föregående dag plus data upp till aktuellt datum och tid
• Idag - Synkroniserar alla data för aktuellt datum upp till aktuell tid
• Igår - Synkroniserar alla data för hela föregående dag

Obs: Home Assistant-automatiseringar stöder inte alternativen "Realtid", "Sedan senaste synkronisering" eller "Senaste 7 dagarna".

Sammanfatta data

Växla Sammanfatta data PÅ eller AV för Health Metrics.

• PÅ - Ger aggregerade datasammanfattningar (standard)
• AV - Ger desagregerade data där det är möjligt

Obs: Denna inställning gäller endast för Health Metrics-datatyp.

Tidsgruppering

När Sammanfatta data är aktiverat, välj hur data ska aggregeras:

• Standard - Ingen aggregering, råa datapunkter
• Dagar - Grupperar data per dag (rekommenderas)

Synkroniseringsfrekvens

Konfigurera hur ofta automatiseringen ska synkronisera data med Home Assistant:

Välj ett nummer och intervall.

Testning och verifiering

Manuell testning

1. Tryck på "Manuell export" på automatiseringens konfigurationsskärm
2. Välj ett datumintervall
3. Tryck på "Exportera" för att skicka en testbegäran
4. Kontrollera i Home Assistant att sensorstatusen har skapats/uppdaterats

Verifiering i Home Assistant

1. Öppna Home Assistant
2. Gå till Utvecklarverktyg > Statusar
3. Sök efter hae.{your_automation_name} (gemener, inga mellanslag)
4. Verifiera att sensorstatusen visar dina hälsodata
5. Kontrollera "Senast uppdaterad"-tidsstämpeln för att bekräfta nyliga synkroniseringar

Visa aktivitetsloggar

1. Tryck på "Visa aktivitetsloggar" på automatiseringens konfigurationsskärm
2. Granska nyliga automatiseringar
3. Kontrollera efter fel eller varningar
4. Verifiera begäranstidsstämplar och svarsstatus

Kontrollera Home Assistant-loggar

Om data inte visas i Home Assistant:

1. Öppna Home Assistant
2. Gå till Inställningar > System > Loggar
3. Leta efter fel relaterade till REST API eller sensorstatusar
4. Kontrollera efter autentiseringsfel eller ogiltigt dataformat

Felsökning

Vanliga problem

Autentiseringsfel

• Verifiera att din Långlivade åtkomsttoken är korrekt
• Se till att Authorization-huvudet är formaterat som: Bearer YOUR_TOKEN
• Kontrollera att tokenen inte har gått ut eller återkallats
• Verifiera att tokenen har lämpliga behörigheter i Home Assistant

Sensor visas inte i Home Assistant

• Kontrollera att automatiseringsnamnet inte innehåller specialtecken
• Verifiera entitets-ID-formatet: hae.{automation_name} (gemener, inga mellanslag)
• Kontrollera Home Assistant-loggar för fel
• Se till att API-begäran lyckades (kontrollera Aktivitetsloggar)

Data uppdateras inte

• Kontrollera att automatiseringen är aktiverad
• Granska Aktivitetsloggar för fel
• Se till att nätverksanslutningen till Home Assistant fungerar

Anslutningstimeout

• Verifiera att Home Assistant körs och är tillgänglig
• Kontrollera nätverksanslutningen
• Öka inställningen Begäranstimeout om Home Assistant svarar långsamt
• Verifiera att URL:en och porten är korrekta

Felmeddelanden

Appen visar felmeddelanden om:

• URL:en är ogiltig eller otillgänglig
• Autentiseringen misslyckas (kontrollera Authorization-huvudet)
• Home Assistant returnerar en felstatuskod
• Nätverksanslutningen inte är tillgänglig

Kontrollera Aktivitetsloggarna för detaljerad felinformation, inklusive HTTP-statuskoder och felmeddelanden från Home Assistant.

Home Assistant-integrationstips

Använda hälsodata i automatiseringar

När dina hälsodata är synkroniserade med Home Assistant kan du använda dem i automatiseringar:

automation:
  - alias: "Bra sömnkvalitet"
    trigger:
      - platform: numeric_state
        entity_id: sensor.hae_myhealthdata_sleep_total
        above: 7
    action:
      - service: notify.mobile_app_your_phone
        data:
          message: "Fantastisk sömn igår kväll!"

Skapa instrumentpaneler

Lägg till hälsomätvärden på din Home Assistant-instrumentpanel:

1. Gå till din instrumentpanel
2. Lägg till ett nytt kort
3. Välj korttypen "Entiteter" eller "Gauge"
4. Lägg till sensor-entiteterna hae.{your_automation_name}

Sensorstatusstruktur

Sensorstatusen i Home Assistant innehåller:

• state: Det aktuella värdet eller statusen
• attributes: Ytterligare data inklusive:
  • Tidsstämpelinformation
  • Datastruktur som matchar det exporterade JSON-formatet
  • Enhetsinformation där det är tillämpligt

Tips och bästa praxis

1. Namngivning:

   • Undvik specialtecken som kan orsaka problem

2. Dataval:

   • Välj endast de mätvärden du behöver