Synkroniser Apple Health-data med Home Assistant

Home Assistant-automatiseringer giver dig mulighed for automatisk at synkronisere dine sundhedsdata med Home Assistant som sensorstatusser. Denne integration giver dig mulighed for at bruge dine sundhedsdata i Home Assistant-automatiseringer, dashboards og andre integrationer.

Oversigt

Home Assistant-automatiseringer sender dine sundhedsmålinger til Home Assistants REST API, hvilket opretter eller opdaterer sensorstatusser, der kan bruges i hele din Home Assistant-instans. Dataene er formateret specifikt til Home Assistants /states/ API.

Anvendelsestilfælde:

• Vis sundhedsmålinger på Home Assistant-dashboards
• Opret automatiseringer baseret på sundhedsdata
• Integrer sundhedsdata med andre smart home-enheder
• Spor sundhedstendenser over tid i Home Assistant

Nøglefunktioner:

• Automatisk sensorstatusoprettelse
• Kun JSON-format (optimeret til Home Assistant)
• Kun Health Metrics-datatype
• Simpel URL-konfiguration

Begrænsninger

• Adgang til sundhedsdata: Apps må ikke få adgang til sundhedsdata, mens iPhone er låst. Automatiseringer kører kun i perioder, hvor din enhed er låst op. Dette kan påvirke datafriskheden. Se instruktioner til manuel synkronisering for at holde data opdateret.

• Baggrundsbehandling: iOS begrænser baggrundsbehandling for at bevare batterilevetiden. Automatiseringer er afhængige af App-aktualisering i baggrunden og kører muligvis ikke med det samme, hvis:

  • App-aktualisering i baggrunden er deaktiveret for appen
  • Enheden er i Strømbesparelse-tilstand
  • Enheden har været inaktiv i længere perioder
  • Systemressourcer er begrænsede
  • Flere apps konkurrerer om baggrundsudførelsestid

• Understøtter kun Health Metrics-datatype

• Kun JSON-format (kan ikke ændres)

Forudsætninger

• En Home Assistant-instans, der kører og er tilgængelig på dit netværk
• Home Assistant API-adgangstoken (Langtidsadgangstoken)
• Netværksforbindelse til din Home Assistant-instans
• Home Assistant-version, der understøtter REST API

Konfiguration

Naviger til skærmen Automatiske eksporter fra hovednavigationen, tryk derefter på "Ny automatisering" og vælg "Home Assistant" som Automatiseringstype.

Automatiseringsnavn

Indtast et beskrivende navn til din automatisering. Dette navn bruges til at generere sensor-entitets-ID'et i Home Assistant.

Bemærk: Automatiseringsnavnet konverteres til små bogstaver med fjernede mellemrum for at oprette entitets-ID'et. For eksempel bliver "Mine sundhedsdata" til hae.minesundhedsdata.

Notifikationer

Konfigurer, hvornår du vil modtage notifikationer:

• Notificer ved cacheopdatering - Modtag en notifikation, når cachede data opdateres
• Notificer ved kørsel - Modtag en notifikation hver gang automatiseringen udføres

Home Assistant-URL

Indtast basis-URL'en for din Home Assistant-instans. Dette skal indeholde protokollen og porten, hvis du ikke bruger standarden.

Eksempel-URL'er:

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

Bemærk: URL'en skal være tilgængelig fra din enhed. Hvis du bruger HTTPS, skal du sikre, at dit certifikat er gyldigt, eller tilføj en undtagelse.

Automatisk genereret endpoint

Appen genererer automatisk det fulde API-endpoint baseret på dit automatiseringsnavn:

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

For eksempel, hvis din URL er http://homeassistant.local:8123 og dit automatiseringsnavn er "Sundhedsmålinger", bliver endpointet:

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

Dette endpoint vises under URL-feltet som reference.

Anmodningstimeout

Vælg et timeout-interval til HTTP-anmodninger til Home Assistant.

Tilgængelige timeout-indstillinger:

• 60 sekunder - Standard, egnet til de fleste Home Assistant-instanser
• 300 sekunder (5 minutter) - Til langsommere Home Assistant-instanser
• 1800 sekunder (30 minutter) - Til meget langsom behandling
• 3600 sekunder (1 time) - Maksimal anbefalet timeout

HTTP-headere

Tilføj autentificeringsheadere til adgang til Home Assistant API. Du skal tilføje en Authorization-header med dit Langtidsadgangstoken.

Påkrævet header:

• Authorization: Bearer YOUR_LONG_LIVED_ACCESS_TOKEN

For at få et Langtidsadgangstoken:

1. Åbn Home Assistant
2. Gå til din profil (klik på dit navn nederst til venstre)
3. Scroll ned til "Langtidsadgangstokens"
4. Klik på "Opret token"
5. Giv det et navn (f.eks. "Health Auto Export")
6. Kopiér tokenet og indsæt det i header-værdifeltet

Valgfrie headere:
Du kan tilføje yderligere headere, hvis det er nødvendigt til din Home Assistant-opsætning.

For at tilføje headere:

1. Tryk på "Tilføj headere"
2. Indtast header-nøglen i venstre felt
3. Indtast header-værdien i højre felt
4. Gentag for yderligere headere

Vigtigt: Hver header-nøgle skal have en tilsvarende værdi. Tomme headere ignoreres.

Datatypeindstillinger

Datatype

Bemærk: Home Assistant-automatiseringer understøtter kun Health Metrics-datatype. Denne indstilling kan ikke ændres og sættes automatisk til Health Metrics.

Health Metrics-konfiguration

Vælg Health Metrics - Vælg, hvilke specifikke målinger der skal inkluderes. Du kan vælge alle tilgængelige målinger eller vælge specifikke.

Tip: At vælge kun de målinger, du har brug for, kan forbedre behandlingstiden og reducere datastørrelsen sendt til Home Assistant.

Foretrukne kilder - Konfigurer, hvilke datakilder der har prioritet, når flere kilder leverer den samme måling.

Eksportindstillinger

Eksportformat

Bemærk: Home Assistant-automatiseringer understøtter kun JSON-format. Denne indstilling kan ikke ændres og sættes automatisk til JSON.

Eksportversion

Bemærk: Eksportversion er ikke tilgængelig for Home Assistant-automatiseringer, da formatet er optimeret specifikt til Home Assistants state API.

Datointerval

Vælg, hvornår data skal eksporteres:

• Standard - Synkroniserer data for hele den foregående dag plus data op til den aktuelle dato og tid
• I dag - Synkroniserer alle data for den aktuelle dato op til den aktuelle tid
• I går - Synkroniserer alle data for hele den foregående dag

Bemærk: Home Assistant-automatiseringer understøtter ikke "Realtid", "Siden sidste synkronisering" eller "Sidste 7 dage"-indstillinger.

Sammenfat data

Slå Sammenfat data TIL eller FRA for Health Metrics.

• TIL - Giver aggregerede datasammenfattelser (standard)
• FRA - Giver disaggregerede data, hvor det er muligt

Bemærk: Denne indstilling gælder kun for Health Metrics-datatype.

Tidsgruppering

Når Sammenfat data er aktiveret, vælg, hvordan data skal aggregeres:

• Standard - Ingen aggregering, rå datapunkter
• Dage - Grupperer data efter dag (anbefalet)

Synkroniseringsfrekvens

Konfigurer, hvor ofte automatiseringen skal synkronisere data med Home Assistant:

Vælg et tal og interval.

Test og verifikation

Manuel test

1. Tryk på "Manuel eksport" på automatiseringens konfigurationsskærm
2. Vælg et datointerval
3. Tryk på "Eksporter" for at sende en testanmodning
4. Tjek i Home Assistant, at sensorstatusen er oprettet/opdateret

Verifikation i Home Assistant

1. Åbn Home Assistant
2. Gå til Udviklerværktøjer > Statusser
3. Søg efter hae.{your_automation_name} (små bogstaver, ingen mellemrum)
4. Verificer, at sensorstatusen viser dine sundhedsdata
5. Tjek "Sidst opdateret"-tidsstemplet for at bekræfte nylige synkroniseringer

Vis aktivitetslogfiler

1. Tryk på "Vis aktivitetslogfiler" på automatiseringens konfigurationsskærm
2. Gennemgå nylige automatiseringer
3. Tjek efter fejl eller advarsler
4. Verificer anmodningstidsstempler og responsstatus

Tjek Home Assistant-logfiler

Hvis data ikke vises i Home Assistant:

1. Åbn Home Assistant
2. Gå til Indstillinger > System > Logfiler
3. Kig efter fejl relateret til REST API eller sensorstatusser
4. Tjek efter autentificeringsfejl eller ugyldigt dataformat

Fejlfinding

Almindelige problemer

Autentificeringsfejl

• Verificer, at dit Langtidsadgangstoken er korrekt
• Sørg for, at Authorization-headeren er formateret som: Bearer YOUR_TOKEN
• Tjek, at tokenet ikke er udløbet eller tilbagekaldt
• Verificer, at tokenet har passende tilladelser i Home Assistant

Sensor vises ikke i Home Assistant

• Tjek, at automatiseringsnavnet ikke indeholder specialtegn
• Verificer entitets-ID-formatet: hae.{automation_name} (små bogstaver, ingen mellemrum)
• Tjek Home Assistant-logfiler for fejl
• Sørg for, at API-anmodningen var succesfuld (tjek Aktivitetslogfiler)

Data opdateres ikke

• Tjek, at automatiseringen er aktiveret
• Gennemgå Aktivitetslogfiler for fejl
• Sørg for netværksforbindelse til Home Assistant

Forbindelsestimeout

• Verificer, at Home Assistant kører og er tilgængelig
• Tjek netværksforbindelsen
• Øg indstillingen Anmodningstimeout, hvis Home Assistant reagerer langsomt
• Verificer, at URL'en og porten er korrekte

Fejlmeddelelser

Appen viser fejlmeddelelser, hvis:

• URL'en er ugyldig eller utilgængelig
• Autentificering mislykkes (tjek Authorization-headeren)
• Home Assistant returnerer en fejlstatuskode
• Netværksforbindelse ikke er tilgængelig

Tjek Aktivitetslogfilerne for detaljerede fejloplysninger, herunder HTTP-statuskoder og fejlmeddelelser fra Home Assistant.

Home Assistant-integrationstips

Brug sundhedsdata i automatiseringer

Når dine sundhedsdata er synkroniseret med Home Assistant, kan du bruge dem i automatiseringer:

automation:
  - alias: "God søvnkvalitet"
    trigger:
      - platform: numeric_state
        entity_id: sensor.hae_myhealthdata_sleep_total
        above: 7
    action:
      - service: notify.mobile_app_your_phone
        data:
          message: "Fantastisk søvn i går aftes!"

Opret dashboards

Tilføj sundhedsmålinger til dit Home Assistant-dashboard:

1. Gå til dit dashboard
2. Tilføj et nyt kort
3. Vælg korttypen "Entiteter" eller "Gauge"
4. Tilføj sensor-entiteterne hae.{your_automation_name}

Sensorstatusstruktur

Sensorstatusen i Home Assistant indeholder:

• state: Den aktuelle værdi eller status
• attributes: Yderligere data inklusive:
  • Tidsstempeloplysninger
  • Datastruktur, der matcher det eksporterede JSON-format
  • Enhedsoplysninger, hvor det er relevant

Tips og bedste praksis

1. Navngivning:

   • Undgå specialtegn, der kan forårsage problemer

2. Datavalgs:

   • Vælg kun de målinger, du har brug for