Synchronizace dat Apple Health do Home Assistant

Integrujte svá zdravotní data s Home Assistant.

Last updated: February 5, 2026

Na této stránce

Automatizace Home Assistant umožňují automaticky synchronizovat zdravotní data do Home Assistantu jako stavy senzorů. Díky tomu můžete zdravotní data používat v automatizacích Home Assistantu, na dashboardech i v dalších integracích.

Přehled

Automatizace Home Assistant odesílají zdravotní metriky do REST API Home Assistantu a vytvářejí nebo aktualizují stavy senzorů, které lze následně používat v celé instanci Home Assistantu. Data jsou formátována přímo pro API /states/<entity_id> v Home Assistantu.

Případy použití:

zobrazení zdravotních metrik na dashboardech Home Assistantu
vytváření automatizací založených na zdravotních datech
propojení zdravotních dat s dalšími zařízeními chytré domácnosti
sledování zdravotních trendů v čase přímo v Home Assistantu

Klíčové funkce:

automatické vytváření stavů senzorů
pouze formát JSON, optimalizovaný pro Home Assistant
podpora pouze datového typu Zdravotní metriky
jednoduchá konfigurace URL

Omezení

Přístup ke zdravotním datům: Aplikace nemohou přistupovat ke zdravotním datům, když je iPhone zamknutý. Automatizace proto poběží jen v době, kdy je zařízení odemčené. To může ovlivnit aktuálnost dat. Pokud potřebujete data udržovat aktuální, podívejte se na pokyny pro ruční synchronizaci.
Zpracování na pozadí: iOS omezuje běh na pozadí kvůli šetření baterie. Automatizace spoléhají na Obnovení aplikací na pozadí a nemusí se spustit okamžitě, pokud:
- je pro aplikaci vypnuté Obnovení aplikací na pozadí
- je zařízení v režimu nízké spotřeby
- bylo zařízení delší dobu neaktivní
- jsou systémové prostředky omezené
- si více aplikací současně nárokuje čas pro běh na pozadí
podporován je pouze datový typ Zdravotní metriky
používá se pouze formát JSON a nelze jej změnit

Prerequisites

spuštěná instance Home Assistantu dostupná ve vaší síti
přístupový token do API Home Assistantu, tedy Long-Lived Access Token
síťové připojení k vaší instanci Home Assistantu
verze Home Assistantu, která podporuje REST API

Konfigurace

V hlavní navigaci přejděte na obrazovku Automated Exports, klepněte na „New Automation“ a jako typ automatizace vyberte „Home Assistant“.

Název automatizace

Zadejte popisný název automatizace. Tento název se použije pro vytvoření entity_id senzoru v Home Assistantu.

Poznámka: Název automatizace se převede na malá písmena a odstraní se z něj mezery, aby vzniklo entity_id. Například „My Health Data“ se změní na hae.myhealthdata.

Oznámení

Nastavte, kdy chcete dostávat oznámení:

Notify on Cache Update - dostanete oznámení při aktualizaci dat v mezipaměti
Notify When Run - dostanete oznámení při každém spuštění automatizace

Home Assistant URL

Zadejte základní URL své instance Home Assistantu. Pokud nepoužíváte výchozí nastavení, zahrňte i protokol a port.

Příklady URL:

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

Poznámka: URL musí být dostupná z vašeho zařízení. Pokud používáte HTTPS, ujistěte se, že je certifikát platný, případně přidejte výjimku.

Automaticky vytvořený endpoint

Aplikace automaticky vytvoří kompletní API endpoint podle názvu automatizace:

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

Pokud je například vaše URL http://homeassistant.local:8123 a název automatizace je „Health Metrics“, výsledný endpoint bude:

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

Tento endpoint se pro přehled zobrazuje pod polem URL.

Časový limit požadavku

Vyberte časový limit pro HTTP požadavky do Home Assistantu.

Dostupné možnosti:

60 sekund - výchozí hodnota vhodná pro většinu instancí Home Assistantu
300 sekund (5 minut) - pro pomalejší instance Home Assistantu
1800 sekund (30 minut) - pro velmi pomalé zpracování
3600 sekund (1 hodina) - maximální doporučený časový limit

HTTP Headers

Přidejte ověřovací hlavičky pro přístup k API Home Assistantu. Budete potřebovat hlavičku Authorization s vaším Long-Lived Access Token.

Povinná hlavička:

Authorization: Bearer YOUR_LONG_LIVED_ACCESS_TOKEN

Postup získání Long-Lived Access Token:

Otevřete Home Assistant.
Přejděte do svého profilu kliknutím na jméno vlevo dole.
Sjeďte dolů do části „Long-Lived Access Tokens“.
Klikněte na „Vytvořit token“.
Pojmenujte token, například „Health Auto Export“.
Zkopírujte token a vložte jej do pole s hodnotou hlavičky.

Volitelné hlavičky:
Podle svého nastavení Home Assistantu můžete přidat i další hlavičky.

Postup přidání hlaviček:

Klepněte na „Add Headers“.
Do levého pole zadejte klíč hlavičky.
Do pravého pole zadejte hodnotu hlavičky.
Stejný postup opakujte pro další hlavičky.

Důležité: Každý klíč hlavičky musí mít odpovídající hodnotu. Prázdné hlavičky budou ignorovány.

Nastavení typu dat

Typ dat

Poznámka: Automatizace Home Assistant podporují pouze datový typ Zdravotní metriky. Toto nastavení nelze změnit a automaticky se nastaví na Zdravotní metriky.

Konfigurace zdravotních metrik

Vybrat zdravotní metriky - vyberte, které konkrétní metriky chcete zahrnout. Můžete zvolit všechny dostupné metriky nebo jen některé.

Tip: Výběr jen těch metrik, které skutečně potřebujete, může zrychlit zpracování a zmenšit objem dat odesílaných do Home Assistantu.

Preferované zdroje - nastavte, které zdroje dat mají mít přednost, když stejnou metriku poskytuje více zdrojů.

Nastavení exportu

Formát exportu

Poznámka: Automatizace Home Assistant podporují pouze formát JSON. Toto nastavení nelze změnit a automaticky se nastaví na JSON.

Verze exportu

Poznámka: Verze exportu není u automatizací Home Assistant k dispozici, protože formát je optimalizovaný přímo pro API stavů v Home Assistantu.

Rozsah dat

Vyberte, jaké období se má exportovat:

Výchozí - synchronizuje všechna data za celý předchozí den plus data až do aktuálního data a času
Dnes - synchronizuje všechna data za dnešní den až do aktuálního času
Včera - synchronizuje všechna data za celý předchozí den

Poznámka: Automatizace Home Assistant nepodporují volby „V reálném čase“, „Od poslední synchronizace“ ani „Předchozích 7 dní“.

Souhrnná data

Pro zdravotní metriky zapněte nebo vypněte volbu Souhrnná data.

Zapnuto - poskytuje agregované souhrny dat, což je výchozí nastavení
Vypnuto - tam, kde je to možné, poskytuje neagregovaná data

Poznámka: Toto nastavení platí pouze pro datový typ Zdravotní metriky.

Seskupení podle času

Když jsou Souhrnná data zapnutá, vyberte, jak se mají data agregovat:

Default - bez agregace, pouze surové datové body
Days - seskupí data po dnech, což je doporučená volba

Frekvence synchronizace

Nastavte, jak často má automatizace synchronizovat data do Home Assistantu:

Vyberte číslo a časový interval.

Testování a ověření

Ruční testování

Na obrazovce konfigurace automatizace klepněte na „Manual Export“.
Vyberte rozsah dat.
Klepněte na „Export“ a odešlete testovací požadavek.
V Home Assistantu ověřte, že byl stav senzoru vytvořen nebo aktualizován.

Ověření v Home Assistantu

Otevřete Home Assistant.
Přejděte do Developer Tools > States.
Vyhledejte hae.{your_automation_name} psané malými písmeny a bez mezer.
Ověřte, že stav senzoru obsahuje vaše zdravotní data.
Zkontrolujte časové razítko „Last Updated“, abyste potvrdili nedávnou synchronizaci.

Zobrazení protokolů aktivity

Na obrazovce konfigurace automatizace klepněte na „View Activity Logs“.
Zkontrolujte poslední běhy automatizace.
Podívejte se, zda se nevyskytly chyby nebo varování.
Ověřte časová razítka požadavků a stav odpovědí.

Kontrola logů Home Assistantu

Pokud se data v Home Assistantu nezobrazují:

Otevřete Home Assistant.
Přejděte na Settings > System > Logs.
Hledejte chyby související s REST API nebo stavy senzorů.
Zkontrolujte, zda se nevyskytují chyby ověřování nebo neplatný formát dat.

Troubleshooting

Časté problémy

Chyby ověřování

ověřte, že je Long-Lived Access Token správný
zkontrolujte, že hlavička Authorization má formát Bearer YOUR_TOKEN
ověřte, že token nevypršel a nebyl zneplatněn
potvrďte, že má token v Home Assistantu správná oprávnění

Senzor se v Home Assistantu nezobrazuje

zkontrolujte, že název automatizace neobsahuje speciální znaky
ověřte formát entity_id: hae.{automation_name} malými písmeny a bez mezer
podívejte se do logů Home Assistantu, zda neobsahují chyby
potvrďte, že API požadavek proběhl úspěšně, například podle Activity Logs

Data se neaktualizují

zkontrolujte, že je automatizace zapnutá
projděte Activity Logs kvůli chybám
ověřte síťové připojení k Home Assistantu

Vypršení časového limitu připojení

ověřte, že Home Assistant běží a je dostupný
zkontrolujte síťové připojení
pokud Home Assistant odpovídá pomalu, zvyšte nastavení Request Timeout
ověřte správnost URL i portu

Chybové zprávy

Aplikace zobrazí chybové zprávy v těchto situacích:

URL je neplatná nebo nedostupná
selže ověřování, proto zkontrolujte hlavičku Authorization
Home Assistant vrátí chybový stavový kód
není k dispozici síťové připojení

V Activity Logs najdete podrobnosti o chybách, včetně HTTP stavových kódů a chybových zpráv vrácených z Home Assistantu.

Tipy pro integraci s Home Assistantem

Použití zdravotních dat v automatizacích

Jakmile jsou zdravotní data synchronizovaná do Home Assistantu, můžete je používat v automatizacích:

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!"

Creating Dashboards

Add health metrics to your Home Assistant dashboard:

Go to your dashboard
Add a new card
Select "Entities" or "Gauge" card type
Add the hae.{your_automation_name} sensor entities

Sensor State Structure

The sensor state in Home Assistant contains:

state: The current value or status
attributes: Additional data including:
- Timestamp information
- Data structure matching the exported JSON format
- Unit information where applicable

Tips and Best Practices

Automatická synchronizace:
- Nabíjejte zařízení a používejte Zrcadlení iPhonu (iPhone Mirroring).
  - Při nabíjení iOS méně omezuje výkon, synchronizace může probíhat častěji.
  - Se zrcadlením se iPhone chová jako odemčený; Health Auto Export může číst zdravotní data a spouštět automatizace.
Naming:
- Avoid special characters that might cause issues
Data Selection:
- Select only the metrics you need