Sincronizare date Apple Health cu Home Assistant

Automatizările Home Assistant vă permit să sincronizați automat datele de sănătate cu Home Assistant ca stări de senzori. Această integrare vă permite să folosiți datele de sănătate în automatizări Home Assistant, panouri de control și alte integrări.

Prezentare generală

Automatizările Home Assistant trimit metricile de sănătate către API-ul REST al Home Assistant, creând sau actualizând stări de senzori care pot fi folosite în întreaga instanță Home Assistant. Datele sunt formatate special pentru API-ul /states/<entity_id> al Home Assistant.

Cazuri de utilizare:

• Afișarea metricilor de sănătate pe panourile de control Home Assistant
• Crearea de automatizări bazate pe date de sănătate
• Integrarea datelor de sănătate cu alte dispozitive smart home
• Urmărirea tendințelor de sănătate în timp în Home Assistant

Caracteristici principale:

• Creare automată a stărilor senzorilor
• Doar format JSON (optimizat pentru Home Assistant)
• Doar tipul de date Metrici de sănătate
• Configurare simplă a URL-ului

Limitări

• Acces la date de sănătate: aplicațiile nu au voie să acceseze datele de sănătate cât timp iPhone-ul este blocat. Automatizările rulează doar în perioadele în care dispozitivul este deblocat. Acest lucru poate afecta prospețimea datelor. Consultați instrucțiunile pentru sincronizare manuală pentru a menține datele la zi.

• Procesare în fundal: iOS limitează procesarea în fundal pentru a prelungi durata de viață a bateriei. Automatizările se bazează pe Reîmprospătare aplicație în fundal și s-ar putea să nu ruleze imediat dacă:

  • Reîmprospătarea în fundal este dezactivată pentru aplicație
  • Dispozitivul este în modul de economisire a energiei
  • Dispozitivul a fost inactiv perioade îndelungate
  • Resursele sistemului sunt limitate
  • Mai multe aplicații concurează pentru timp de execuție în fundal

• Suportă doar tipul de date Metrici de sănătate

• Doar format JSON (nu poate fi schimbat)

Cerințe preliminare

• O instanță Home Assistant care rulează și este accesibilă în rețea
• Token de acces API Home Assistant (Long-Lived Access Token)
• Conectivitate la rețea către instanța Home Assistant
• Versiune Home Assistant care suportă API REST

Configurare

Deschideți ecranul Exporturi automate din navigarea principală, apoi atingeți „Automatizare nouă” și selectați „Home Assistant” ca tip de automatizare.

Nume automatizare

Introduceți un nume descriptiv pentru automatizare. Acest nume va fi folosit pentru a genera ID-ul entității senzorului în Home Assistant.

Notă: Numele automatizării va fi convertit la litere mici, fără spații, pentru a crea ID-ul entității. De exemplu, „My Health Data” devine hae.myhealthdata.

Notificări

Configurați când doriți să primiți notificări:

• Notificare la actualizarea cache-ului — primiți o notificare când datele din cache se actualizează
• Notificare la rulare — primiți o notificare de fiecare dată când se execută automatizarea

URL Home Assistant

Introduceți URL-ul de bază al instanței Home Assistant. Trebuie să includă protocolul și portul dacă nu folosiți valorile implicite.

Exemple de URL-uri:

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

Notă: URL-ul trebuie să fie accesibil de pe dispozitiv. Dacă folosiți HTTPS, asigurați-vă că certificatul este valid sau adăugați o excepție.

Endpoint generat automat

Aplicația generează automat endpointul complet al API pe baza numelui automatizării:

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

De exemplu, dacă URL-ul este http://homeassistant.local:8123 iar numele automatizării este „Health Metrics”, endpointul va fi:

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

Acest endpoint este afișat sub câmpul URL ca referință.

Timeout cerere

Selectați un interval de timeout pentru cererile HTTP către Home Assistant.

Opțiuni de timeout disponibile:

• 60 secunde — implicit, potrivit pentru majoritatea instanțelor Home Assistant
• 300 secunde (5 minute) — pentru instanțe Home Assistant mai lente
• 1800 secunde (30 minute) — pentru procesare foarte lentă
• 3600 secunde (1 oră) — timeout maxim recomandat

Antete HTTP

Adăugați antete de autentificare pentru accesul la API-ul Home Assistant. Va trebui să adăugați un antet Authorization cu Long-Lived Access Token.

Antet obligatoriu:

• Authorization: Bearer YOUR_LONG_LIVED_ACCESS_TOKEN

Pentru a obține un Long-Lived Access Token:

1. Deschideți Home Assistant
2. Mergeți la profil (atingeți numele din colțul din stânga jos)
3. Derulați la „Long-Lived Access Tokens”
4. Atingeți „Create Token”
5. Dați-i un nume (ex.: „Health Auto Export”)
6. Copiați tokenul și lipiți-l în câmpul valorii antetului

Antete opționale:
Puteți adăuga antete suplimentare dacă este nevoie pentru configurația Home Assistant.

Pentru a adăuga antete:

1. Atingeți „Adăugați antete”
2. Introduceți cheia antetului în câmpul din stânga
3. Introduceți valoarea antetului în câmpul din dreapta
4. Repetați pentru antete suplimentare

Important: Fiecare cheie de antet trebuie să aibă o valoare corespunzătoare. Antetele goale vor fi ignorate.

Setări tip de date

Tip de date

Notă: Automatizările Home Assistant suportă doar tipul de date Metrici de sănătate. Această setare nu poate fi schimbată și este setată automat la Metrici de sănătate.

Configurare metrici de sănătate

Selectare metrici de sănătate — alegeți ce metrici specifice includeți. Puteți selecta toate metricile disponibile sau doar anumite.

Sfat: Selectarea doar a metricilor de care aveți nevoie poate îmbunătăți timpul de procesare și reduce dimensiunea datelor trimise către Home Assistant.

Surse preferate — configurați ce surse de date au prioritate când mai multe surse oferă aceeași metrică.

Setări export

Format export

Notă: Automatizările Home Assistant suportă doar formatul JSON. Această setare nu poate fi schimbată și este setată automat la JSON.

Versiune export

Notă: Versiunea de export nu este disponibilă pentru automatizările Home Assistant, deoarece formatul este optimizat special pentru API-ul de stări al Home Assistant.

Interval de date

Selectați când trebuie exportate datele:

• Implicit — sincronizează datele pentru întreaga zi anterioară, plus date până la data și ora curente
• Astăzi — sincronizează toate datele pentru ziua curentă până la momentul curent
• Ieri — sincronizează toate datele pentru întreaga zi anterioară

Notă: Automatizările Home Assistant nu suportă opțiunile „Timp real”, „De la ultima sincronizare” sau „Ultimele 7 zile”.

Rezumat date

Comutați Rezumat date activat sau dezactivat pentru Metrici de sănătate.

• Activat — oferă rezumate agregate ale datelor (implicit)
• Dezactivat — oferă date dezagregate pe cât posibil

Notă: Această setare se aplică doar tipului de date Metrici de sănătate.

Grupare temporală

Când Rezumat date este activat, selectați modul în care trebuie agregate datele:

• Implicit — fără agregare, puncte de date brute
• Zile — grupează datele pe zi (recomandat)

Ritm de sincronizare

Configurați cât de des ar trebui să sincronizeze automatizarea datele cu Home Assistant:

Selectați un număr și un interval.

Testare și verificare

Testare manuală

1. Atingeți „Export manual” în ecranul de configurare a automatizării
2. Selectați un interval de date
3. Atingeți „Export” pentru a trimite o cerere de test
4. Verificați în Home Assistant că starea senzorului a fost creată sau actualizată

Verificare în Home Assistant

1. Deschideți Home Assistant
2. Mergeți la Developer Tools > States
3. Căutați hae.{your_automation_name} (litere mici, fără spații)
4. Verificați că starea senzorului afișează datele de sănătate
5. Verificați marcajul temporal „Last Updated” pentru a confirma sincronizările recente

Vizualizare jurnale de activitate

1. Atingeți „Vizualizați jurnalele de activitate” în ecranul de configurare a automatizării
2. Examinați rulările recente ale automatizării
3. Verificați dacă există erori sau avertismente
4. Verificați marcajele temporale ale cererilor și starea răspunsurilor

Verificare jurnale Home Assistant

Dacă datele nu apar în Home Assistant:

1. Deschideți Home Assistant
2. Mergeți la Settings > System > Logs
3. Căutați erori legate de API REST sau de stările senzorilor
4. Verificați erori de autentificare sau format de date nevalid

Depanare

Probleme frecvente

Erori de autentificare

• Verificați că Long-Lived Access Token este corect
• Asigurați-vă că antetul Authorization are formatul: Bearer YOUR_TOKEN
• Verificați că tokenul nu a expirat și nu a fost revocat
• Verificați că tokenul are permisiunile adecvate în Home Assistant

Senzorul nu apare în Home Assistant

• Verificați că numele automatizării nu conține caractere speciale
• Verificați formatul ID-ului entității: hae.{automation_name} (litere mici, fără spații)
• Consultați jurnalele Home Assistant pentru erori
• Asigurați-vă că cererea API a reușit (consultați jurnalele de activitate)

Datele nu se actualizează

• Verificați că automatizarea este activată
• Examinați jurnalele de activitate pentru erori
• Asigurați-vă că există conectivitate la rețea către Home Assistant

Timeout conexiune

• Verificați că Home Assistant rulează și este accesibil
• Verificați conectivitatea la rețea
• Măriți setarea Timeout cerere dacă Home Assistant răspunde lent
• Verificați că URL-ul și portul sunt corecte

Mesaje de eroare

Aplicația va afișa mesaje de eroare dacă:

• URL-ul este nevalid sau nu poate fi accesat
• autentificarea eșuează (verificați antetul Authorization)
• Home Assistant returnează un cod de stare de eroare
• conectivitatea la rețea nu este disponibilă

Consultați jurnalele de activitate pentru informații detaliate despre erori, inclusiv coduri de stare HTTP și mesaje de eroare de la Home Assistant.

Sfaturi integrare Home Assistant

Utilizarea datelor de sănătate în automatizări

După ce datele de sănătate sunt sincronizate cu Home Assistant, le puteți folosi în automatizări:

automation:
  - alias: "Somn de calitate"
    trigger:
      - platform: numeric_state
        entity_id: sensor.hae_myhealthdata_sleep_total
        above: 7
    action:
      - service: notify.mobile_app_your_phone
        data:
          message: "Somn excelent azi-noapte!"

Crearea panourilor de control

Adăugați metrici de sănătate la panoul de control Home Assistant:

1. Mergeți la panoul de control
2. Adăugați un card nou
3. Selectați tipul de card „Entities” sau „Gauge”
4. Adăugați entitățile senzorilor hae.{your_automation_name}

Structura stării senzorului

Starea senzorului în Home Assistant conține:

• state: valoarea sau starea curentă
• attributes: date suplimentare, inclusiv:
  • informații despre marcaje temporale
  • structură de date care se potrivește cu formatul JSON exportat
  • informații despre unități, unde este cazul

Sfaturi și bune practici

1. Sincronizare automată:

   • Încărcați dispozitivul și folosiți iPhone Mirroring
     • Când dispozitivul se încarcă, iOS aplică mai puține restricții asupra performanței, astfel că datele se pot sincroniza mai frecvent
     • Folosind iPhone Mirroring, dispozitivul se comportă la fel ca atunci când ar fi deblocat. Astfel, datele de sănătate sunt accesibile pentru Health Auto Export, pentru a rula acțiuni automate

2. Denumire:

   • Evitați caracterele speciale care ar putea cauza probleme

3. Selecție date:

   • Selectați doar metricile de care aveți nevoie