Sinkronizacija podataka Apple Zdravlja s Home Assistantom

Integrirajte zdravstvene podatke s Home Assistantom.

Last updated: February 5, 2026

Na ovoj stranici

Automatizacije za Home Assistant omogućuju automatsku sinkronizaciju zdravstvenih podataka u Home Assistant kao stanja senzora. Ta integracija omogućuje korištenje zdravstvenih podataka u automatizacijama Home Assistant, nadzornim pločama i drugim integracijama.

Pregled

Automatizacije za Home Assistant šalju zdravstvene metrike na REST API Home Assistanta, stvarajući ili ažurirajući stanja senzora koja se mogu koristiti u cijeloj instanci Home Assistanta. Podaci su formatirani posebno za API Home Assistanta /states/<entity_id>.

Primjene:

Prikaz zdravstvenih metrika na nadzornim pločama Home Assistanta
Stvaranje automatizacija na temelju zdravstvenih podataka
Integracija zdravstvenih podataka s drugim pametnim uređajima
Praćenje zdravstvenih trendova u Home Assistantu

Ključne značajke:

Automatsko stvaranje stanja senzora
Samo JSON format (optimizirano za Home Assistant)
Samo vrsta podataka Health Metrics
Jednostavna konfiguracija URL-a

Ograničenja

Pristup zdravstvenim podacima: Aplikacijama nije dopušten pristup zdravstvenim podacima dok je iPhone zaključan. Automatizacije će raditi samo kad je uređaj otključan. To može utjecati na svježinu podataka. Pogledajte upute za ručnu sinkronizaciju kako biste održali podatke ažurnima.
Obrada u pozadini: iOS ograničava obradu u pozadini radi uštede baterije. Automatizacije ovise o osvježavanju aplikacija u pozadini i možda neće odmah raditi ako:
- je osvježavanje aplikacija u pozadini isključeno za aplikaciju
- je uređaj u načinu niske potrošnje
- je uređaj dugo neaktivan
- su resursi sustava ograničeni
- više aplikacija istodobno traži vrijeme izvršavanja u pozadini
Podržana je samo vrsta podataka Health Metrics
Samo JSON format (ne može se promijeniti)

Preduvjeti

Pokrenuta i dostupna instanca Home Assistanta na vašoj mreži
API pristupni token Home Assistanta (Long-Lived Access Token)
Mrežna povezanost s instancom Home Assistanta
Verzija Home Assistanta koja podržava REST API

Konfiguracija

U glavnoj navigaciji otvorite zaslon Automatskih izvoza, zatim dodirnite „New Automation” i odaberite „Home Assistant” kao vrstu automatizacije.

Naziv automatizacije

Unesite opisni naziv automatizacije. Taj naziv koristit će se za generiranje ID-a entiteta senzora u Home Assistantu.

Napomena: Naziv automatizacije pretvara se u mala slova bez razmaka radi stvaranja ID-a entiteta. Primjerice, „My Health Data” postaje hae.myhealthdata.

Obavijesti

Postavite kada želite primati obavijesti:

Notify on Cache Update — obavijest kad se ažuriraju predmemorirani podaci
Notify When Run — obavijest pri svakom izvršavanju automatizacije

URL Home Assistanta

Unesite bazni URL instance Home Assistanta. Uključite protokol i priključak ako ne koristite zadani.

Primjeri URL-ova:

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

Napomena: URL mora biti dostupan s vašeg uređaja. Ako koristite HTTPS, provjerite je li certifikat valjan ili dodajte iznimku.

Automatski generirani endpoint

Aplikacija automatski generira puni API endpoint na temelju naziva automatizacije:

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

Primjerice, ako je URL http://homeassistant.local:8123, a naziv automatizacije „Health Metrics”, endpoint će biti:

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

Ovaj endpoint prikazan je ispod polja URL-a radi referencije.

Istek zahtjeva (Request Timeout)

Odaberite interval isteka za HTTP zahtjeve prema Home Assistantu.

Dostupne opcije isteka:

60 sekundi — zadano, prikladno za većinu instanci
300 sekundi (5 minuta) — za sporije instance
1800 sekundi (30 minuta) — za vrlo sporu obradu
3600 sekundi (1 sat) — maksimalno preporučeni istek

HTTP zaglavlja

Dodajte zaglavlja autentifikacije za pristup API-ju Home Assistanta. Trebate dodati zaglavlje Authorization s Long-Lived Access Tokenom.

Obavezno zaglavlje:

Authorization: Bearer YOUR_LONG_LIVED_ACCESS_TOKEN

Kako dobiti Long-Lived Access Token:

Otvorite Home Assistant
Idite na profil (klik na ime dolje lijevo)
Pomaknite se do „Long-Lived Access Tokens”
Kliknite „Create Token”
Dajte mu naziv (npr. „Health Auto Export”)
Kopirajte token i zalijepite u polje vrijednosti zaglavlja

Opcionalna zaglavlja:
Možete dodati dodatna zaglavlja ako vaša postavka Home Assistanta to zahtijeva.

Dodavanje zaglavlja:

Dodirnite „Add Headers”
Unesite ključ zaglavlja u lijevo polje
Unesite vrijednost zaglavlja u desno polje
Ponovite za dodatna zaglavlja

Važno: Svaki ključ zaglavlja mora imati odgovarajuću vrijednost. Prazna zaglavlja bit će zanemarena.

Postavke vrste podataka

Vrsta podataka

Napomena: Automatizacije za Home Assistant podržavaju samo vrstu Health Metrics. Ova se postavka ne može promijeniti i automatski je postavljena na Health Metrics.

Konfiguracija zdravstvenih metrika

Select Health Metrics — odaberite koje metrike uključiti. Možete odabrati sve dostupne ili pojedinačne.

Savjet: Odabirom samo potrebnih metrika možete poboljšati vrijeme obrade i smanjiti količinu podataka poslanih u Home Assistant.

Preferred Sources — postavite koji izvori imaju prednost kad više izvora daje istu metriku.

Postavke izvoza

Format izvoza

Napomena: Automatizacije za Home Assistant podržavaju samo JSON format. Ova se postavka ne može promijeniti i automatski je JSON.

Verzija izvoza

Napomena: Verzija izvoza nije dostupna za automatizacije Home Assistanta jer je format posebno optimiziran za state API Home Assistanta.

Raspon datuma

Odaberite kada izvesti podatke:

Default — sinkronizira podatke za cijeli prethodni dan plus podatke do trenutnog datuma i vremena
Today — sinkronizira sve podatke za tekući dan do trenutnog vremena
Yesterday — sinkronizira sve podatke za cijeli prethodni dan

Napomena: Automatizacije Home Assistanta ne podržavaju opcije „Real Time”, „Since Last Sync” ni „Previous 7 Days”.

Summarize Data

Uključite ili isključite Summarize Data za Health Metrics.

ON — agregirani sažeci (zadano)
OFF — gdje je moguće, pojedinačne točke podataka

Napomena: Postavka vrijedi samo za vrstu podataka Health Metrics.

Vremensko grupiranje

Kad je Summarize Data uključeno, odaberite kako agregirati podatke:

Default — bez agregacije, sirove točke podataka
Days — grupiranje po danu (preporučeno)

Učestalost sinkronizacije

Postavite koliko često automatizacija treba sinkronizirati podatke u Home Assistant:

Odaberite broj i interval.

Testiranje i provjera

Ručno testiranje

Na zaslonu konfiguracije dodirnite „Manual Export”
Odaberite raspon datuma
Dodirnite „Export” za slanje probnog zahtjeva
Provjerite u Home Assistantu je li stanje senzora stvoreno ili ažurirano

Provjera u Home Assistantu

Otvorite Home Assistant
Idite na Developer Tools > States
Pretražite hae.{your_automation_name} (mala slova, bez razmaka)
Provjerite prikazuju li stanje senzora vaše zdravstvene podatke
Provjerite vrijeme „Last Updated” radi nedavnih sinkronizacija

Pregled zapisa aktivnosti

Dodirnite „View Activity Logs”
Pregledajte nedavna pokretanja
Provjerite greške ili upozorenja
Provjerite vremenske oznake zahtjeva i status odgovora

Provjera zapisa Home Assistanta

Ako se podaci ne pojavljuju u Home Assistantu:

Otvorite Home Assistant
Idite na Settings > System > Logs
Tražite greške vezane uz REST API ili stanja senzora
Provjerite greške autentifikacije ili nevažeći format podataka

Rješavanje problema

Uobičajeni problemi

Greške autentifikacije

Provjerite je li Long-Lived Access Token ispravan
Provjerite je li zaglavlje Authorization u obliku: Bearer YOUR_TOKEN
Provjerite nije li token istekao ili opozvan
Provjerite ima li token odgovarajuća dopuštenja u Home Assistantu

Senzor se ne pojavljuje u Home Assistantu

Provjerite ne sadrži li naziv automatizacije posebne znakove
Provjerite format ID-a entiteta: hae.{automation_name} (mala slova, bez razmaka)
Pogledajte zapise Home Assistanta radi grešaka
Provjerite je li API zahtjev uspio (Activity Logs)

Podaci se ne ažuriraju

Provjerite je li automatizacija uključena
Pregledajte Activity Logs radi grešaka
Provjerite mrežnu povezanost s Home Assistantom

Istek veze (timeout)

Provjerite radi li Home Assistant i je li dostupan
Provjerite mrežnu povezanost
Povećajte postavku Request Timeout ako Home Assistant sporo odgovara
Provjerite URL i priključak

Poruke o greškama

Aplikacija prikazuje greške ako:

je URL nevažeći ili nedostupan
autentifikacija ne uspije (provjerite zaglavlje Authorization)
Home Assistant vrati grešku statusa
mrežna veza nije dostupna

Pogledajte Activity Logs za detalje, uključujući HTTP status kodove i poruke grešaka iz Home Assistanta.

Savjeti za integraciju Home Assistanta

Korištenje zdravstvenih podataka u automatizacijama

Kad se zdravstveni podaci sinkroniziraju u Home Assistant, možete ih koristiti u automatizacijama:

automation:
  - alias: "Good Sleep Quality"
    trigger:
      - platform: numeric_state
        entity_id: sensor.hae_myhealthdata_sleep_total
        above: 7
    action:
      - service: notify.mobile_app_your_phone
        data:
          message: "Great sleep last night!"

Stvaranje nadzornih ploča

Dodajte zdravstvene metrike na nadzornu ploču Home Assistanta:

Idite na nadzornu ploču
Dodajte novu karticu
Odaberite tip kartice „Entities” ili „Gauge”
Dodajte entitete senzora hae.{your_automation_name}

Struktura stanja senzora

Stanje senzora u Home Assistantu sadrži:

state: trenutačna vrijednost ili status
attributes: dodatni podaci uključujući:
- informacije o vremenskoj oznaci
- strukturu podataka koja odgovara izvezenom JSON formatu
- informacije o jedinicama gdje je primjenjivo

Savjeti i najbolje prakse

Automatska sinkronizacija:
- Punite uređaj i koristite iPhone Mirroring
  - Kad se uređaj puni, iOS manje ograničava performanse pa se podaci mogu češće sinkronizirati
  - iPhone Mirroring ponaša se kao da je uređaj otključan, pa Health Auto Export može pristupiti zdravstvenim podacima za automatizirane radnje
Imenovanje:
- Izbjegavajte posebne znakove koji mogu uzrokovati probleme
Odabir podataka:
- Odaberite samo metrike koje trebate