Synchronizácia do Home Assistant

Integrujte zdravotné údaje s Home Assistant.

Last updated: April 6, 2026

Na tejto stránke

Automatizácie Home Assistant umožňujú automaticky synchronizovať zdravotné údaje do Home Assistant ako stavy senzorov. Táto integrácia umožňuje používať zdravotné údaje v automatizáciách Home Assistant, dashboardoch a ďalších integráciách.

Prehľad

Automatizácie Home Assistant posielajú zdravotné metriky na REST API Home Assistant a vytvárajú alebo aktualizujú stavy senzorov, ktoré môžete používať v celej inštancii Home Assistant. Údaje sú formátované špecificky pre API Home Assistant /states/<entity_id>.

Prípady použitia:

Zobrazenie zdravotných metrík na dashboardoch Home Assistant
Tvorba automatizácií na základe zdravotných údajov
Integrácia zdravotných údajov s ďalšími zariadeniami smart home
Sledovanie zdravotných trendov v čase v Home Assistant

Hlavné funkcie:

Automatické vytváranie stavu senzora
Len formát JSON (optimalizovaný pre Home Assistant)
Len typ údajov Zdravotné metriky
Jednoduchá konfigurácia URL

Obmedzenia

Prístup k zdravotným údajom: Aplikácie nemôžu pristupovať k zdravotným údajom, kým je iPhone zamknutý. Automatizácie bežia len vtedy, keď je zariadenie odomknuté. To môže ovplyvniť čerstvosť údajov. Pozrite pokyny na manuálnu synchronizáciu, aby ste údaje udržali aktuálne.
Spracovanie na pozadí: iOS obmedzuje spracovanie na pozadí kvôli výdrži batérie. Automatizácie závisia od obnovenia aplikácií na pozadí a nemusia sa spustiť okamžite, ak:
- je pre aplikáciu vypnuté obnovenie aplikácií na pozadí,
- je zariadenie v úspornom režime,
- bolo zariadenie dlhší čas neaktívne,
- sú obmedzené systémové zdroje,
- viac aplikácií súperí o čas vykonávania na pozadí.
Podporuje len typ údajov Zdravotné metriky
Len formát JSON (nedá sa zmeniť)

Predpoklady

Bežiaca a dostupná inštancia Home Assistant vo vašej sieti
Prístupový token API Home Assistant (Long-Lived Access Token)
Sieťové pripojenie k inštancii Home Assistant
Verzia Home Assistant s podporou REST API

Konfigurácia

Prejdite na obrazovku Automatizované exporty v hlavnej navigácii, potom klepnite na „Nová automatizácia“ a ako typ automatizácie vyberte „Home Assistant“.

Názov automatizácie

Zadajte výstižný názov automatizácie. Tento názov sa použije na vygenerovanie ID entity senzora v Home Assistant.

Poznámka: Názov automatizácie sa prevedie na malé písmená a odstránia sa medzery, aby vzniklo ID entity. Napríklad „My Health Data“ sa zmení na hae.myhealthdata.

Upozornenia

Nastavte, kedy chcete dostávať upozornenia:

Upozorniť pri aktualizácii vyrovnávacej pamäte — upozornenie pri aktualizácii dát vo vyrovnávacej pamäti
Upozorniť pri spustení — upozornenie pri každom spustení automatizácie

URL Home Assistant

Zadajte základnú URL inštancie Home Assistant. Mala by zahŕňať protokol a port, ak nepoužívate predvolený port.

Príklady URL:

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

Poznámka: URL musí byť zo zariadenia dostupná. Pri HTTPS sa uistite, že je certifikát platný alebo pridajte výnimku.

Automaticky generovaný koncový bod

Aplikácia automaticky vygeneruje úplný koncový bod API podľa názvu automatizácie:

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

Napríklad ak je vaša URL http://homeassistant.local:8123 a názov automatizácie je „Health Metrics“, koncový bod bude:

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

Tento koncový bod sa zobrazuje pod poľom URL ako referencia.

Časový limit požiadavky

Vyberte interval časového limitu pre HTTP požiadavky na Home Assistant.

Dostupné možnosti časového limitu:

60 sekúnd — predvolené, vhodné pre väčšinu inštancií Home Assistant
300 sekúnd (5 minút) — pre pomalšie inštancie Home Assistant
1800 sekúnd (30 minút) — pri veľmi pomalom spracovaní
3600 sekúnd (1 hodina) — maximálny odporúčaný časový limit

HTTP hlavičky

Pridajte autentifikačné hlavičky pre prístup k API Home Assistant. Musíte pridať hlavičku Authorization s Long-Lived Access Tokenom.

Povinná hlavička:

Authorization: Bearer YOUR_LONG_LIVED_ACCESS_TOKEN

Získanie Long-Lived Access Tokenu:

Otvorte Home Assistant
Prejdite do profilu (klepnite na svoje meno vľavo dole)
Posuňte sa nadol na „Long-Lived Access Tokens“
Klepnite na „Create Token“
Zadajte názov (napr. „Health Auto Export“)
Skopírujte token a vložte ho do poľa hodnoty hlavičky

Voliteľné hlavičky:
Podľa potreby môžete pridať ďalšie hlavičky pre vaše nastavenie Home Assistant.

Pridanie hlavičiek:

Klepnite na „Pridať hlavičky“
Zadajte kľúč hlavičky do ľavého poľa
Zadajte hodnotu hlavičky do pravého poľa
Opakujte pre ďalšie hlavičky

Dôležité: Každý kľúč hlavičky musí mať zodpovedajúcu hodnotu. Prázdne hlavičky sa ignorujú.

Nastavenia typu údajov

Typ údajov

Poznámka: Automatizácie Home Assistant podporujú len typ údajov Zdravotné metriky. Toto nastavenie sa nedá zmeniť a automaticky sa nastaví na Zdravotné metriky.

Konfigurácia zdravotných metrík

Vybrať zdravotné metriky — vyberte konkrétne metriky na zahrnutie. Môžete vybrať všetky dostupné metriky alebo len vybrané.

Tip: Výber len potrebných metrík môže skrátiť čas spracovania a zmenšiť objem údajov odoslaných do Home Assistant.

Preferované zdroje — nastavte, ktoré zdroje údajov majú prednosť, keď viac zdrojov poskytuje rovnakú metriku.

Nastavenia exportu

Formát exportu

Poznámka: Automatizácie Home Assistant podporujú len formát JSON. Toto nastavenie sa nedá zmeniť a automaticky sa nastaví na JSON.

Verzia exportu

Poznámka: Verzia exportu nie je pre automatizácie Home Assistant k dispozícii, pretože je formát optimalizovaný špecificky pre state API Home Assistant.

Časové rozpätie

Vyberte, kedy sa majú údaje exportovať:

Predvolené — synchronizuje údaje za celý predchádzajúci deň plus údaje do aktuálneho dátumu a času
Dnes — synchronizuje všetky údaje za aktuálny deň do aktuálneho času
Včera — synchronizuje všetky údaje za celý predchádzajúci deň

Poznámka: Automatizácie Home Assistant nepodporujú možnosti „Real Time“, „Since Last Sync“ ani „Previous 7 Days“.

Zhrnúť údaje

Zapnite alebo vypnite zhrnutie údajov pre Zdravotné metriky.

Zapnuté — poskytuje agregované súhrny údajov (predvolené)
Vypnuté — kde je to možné, poskytuje neagregované údaje

Poznámka: Toto nastavenie platí len pre typ údajov Zdravotné metriky.

Časová agregácia

Pri zapnutom zhrnutí údajov vyberte, ako sa majú údaje agregovať:

Predvolené — bez agregácie, surové body údajov
Dni — zoskupuje údaje po dňoch (odporúčané)

Frekvencia synchronizácie

Nastavte, ako často má automatizácia synchronizovať údaje s Home Assistant:

Vyberte číslo a interval.

Testovanie a overenie

Manuálne testovanie

Na obrazovke konfigurácie automatizácie klepnite na „Manuálny export“
Vyberte časové rozpätie
Klepnite na „Export“ a odošlite testovaciu požiadavku
Skontrolujte Home Assistant a overte, či bol stav senzora vytvorený alebo aktualizovaný

Overenie v Home Assistant

Otvorte Home Assistant
Prejdite na Nástroje pre vývojárov > Stavy
Vyhľadajte hae.{názov_vašej_automatizácie} (malé písmená, bez medzier)
Overte, či stav senzora zobrazuje vaše zdravotné údaje
Skontrolujte časové razítko „Last Updated“, či potvrdzuje nedávne synchronizácie

Denníky aktivít

Na obrazovke konfigurácie automatizácie klepnite na „Zobraziť denníky aktivít“
Skontrolujte nedávne spustenia automatizácie
Hľadajte chyby alebo varovania
Overte časové značky požiadaviek a stav odpovede

Kontrola logov Home Assistant

Ak sa údaje v Home Assistant nezobrazujú:

Otvorte Home Assistant
Prejdite na Nastavenia > Systém > Logy
Hľadajte chyby súvisiace s REST API alebo stavmi senzorov
Skontrolujte chyby autentifikácie alebo neplatný formát údajov

Riešenie problémov

Bežné problémy

Chyby autentifikácie

Overte správnosť Long-Lived Access Tokenu
Uistite sa, že hlavička Authorization má formát: Bearer VÁŠ_TOKEN
Skontrolujte, či platnosť tokenu nevypršala a či nebol zrušený
Overte, či má token v Home Assistant vhodné oprávnenia

Senzor sa nezobrazuje v Home Assistant

Skontrolujte, či názov automatizácie neobsahuje špeciálne znaky
Overte formát ID entity: hae.{názov_automatizácie} (malé písmená, bez medzier)
Pozrite logy Home Assistant kvôli chybám
Uistite sa, že požiadavka API bola úspešná (skontrolujte denníky aktivít)

Údaje sa neaktualizujú

Skontrolujte, či je automatizácia zapnutá
Pozrite denníky aktivít kvôli chybám
Uistite sa, že existuje sieťové pripojenie k Home Assistant

Časový limit pripojenia

Overte, či Home Assistant beží a je dostupný
Skontrolujte sieťové pripojenie
Ak Home Assistant pomaly odpovedá, zvýšte nastavenie časového limitu požiadavky
Overte správnosť URL a portu

Chybové hlásenia

Aplikácia zobrazí chybové hlásenia, ak napríklad:

URL je neplatná alebo nedostupná,
autentifikácia zlyhá (skontrolujte hlavičku Authorization),
Home Assistant vráti chybový stavový kód,
sieťové pripojenie nie je k dispozícii.

Podrobné informácie o chybách nájdete v denníkoch aktivít vrátane HTTP stavových kódov a chybových hlásení z Home Assistant.

Tipy na integráciu s Home Assistant

Použitie zdravotných údajov v automatizáciách

Keď sa zdravotné údaje synchronizujú do Home Assistant, môžete ich používať v automatizáciá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!"

Tvorba dashboardov

Pridajte zdravotné metriky na dashboard Home Assistant:

Prejdite na svoj dashboard
Pridajte novú kartu
Vyberte typ karty „Entities“ alebo „Gauge“
Pridajte entity senzorov hae.{názov_vašej_automatizácie}

Štruktúra stavu senzora

Stav senzora v Home Assistant obsahuje:

state: aktuálna hodnota alebo stav
attributes: ďalšie údaje vrátane:
- informácií o časových razítkach
- štruktúry údajov zodpovedajúcej exportovanému formátu JSON
- informácií o jednotkách, kde je to relevantné

Tipy a osvedčené postupy

Automatická synchronizácia:
- Nabíjajte zariadenie a používajte zrkadlenie iPhonu
  - Pri nabíjaní iOS menej obmedzuje výkon zariadenia, takže sa údaje môžu synchronizovať častejšie
  - Pri zrkadlení iPhonu sa zariadenie správa rovnako ako pri odomknutí. Zdravotné údaje sú tak pre Health Auto Export dostupné na spúšťanie automatizovaných akcií
Pomenovanie:
- Vyhnite sa špeciálnym znakom, ktoré by mohli spôsobiť problémy
Výber údajov:
- Vyberte len metriky, ktoré potrebujete