Synchronizuj dane Apple Health z Home Assistant

Zintegruj swoje dane zdrowotne z Home Assistant.

Last updated: February 5, 2026

On this page

Automatyzacje Home Assistant umożliwiają automatyczną synchronizację danych zdrowotnych z Home Assistant jako stany czujników. Ta integracja pozwala na wykorzystanie danych zdrowotnych w automatyzacjach Home Assistant, panelach i innych integracjach.

Przegląd

Automatyzacje Home Assistant wysyłają Twoje metryki zdrowotne do interfejsu API REST Home Assistant, tworząc lub aktualizując stany czujników, które mogą być używane w całej instancji Home Assistant. Dane są formatowane specjalnie dla interfejsu API /states/ Home Assistant.

Przypadki użycia:

Wyświetlanie metryk zdrowotnych na panelach Home Assistant
Tworzenie automatyzacji na podstawie danych zdrowotnych
Integracja danych zdrowotnych z innymi urządzeniami inteligentnego domu
Śledzenie trendów zdrowotnych w czasie w Home Assistant

Kluczowe funkcje:

Automatyczne tworzenie stanów czujników
Tylko format JSON (zoptymalizowany dla Home Assistant)
Tylko typ danych Health Metrics
Prosta konfiguracja URL

Ograniczenia

Dostęp do danych zdrowotnych: Aplikacje nie mogą uzyskać dostępu do danych zdrowotnych, gdy iPhone jest zablokowany. Automatyzacje będą działać tylko w okresach, gdy urządzenie jest odblokowane. Może to wpłynąć na aktualność danych. Zobacz instrukcje dotyczące ręcznej synchronizacji, aby zachować aktualność danych.
Przetwarzanie w tle: iOS ogranicza przetwarzanie w tle, aby zachować żywotność baterii. Automatyzacje polegają na odświeżaniu aplikacji w tle i mogą nie działać natychmiast, jeśli:
- Odświeżanie aplikacji w tle jest wyłączone dla aplikacji
- Urządzenie jest w trybie oszczędzania energii
- Urządzenie było nieaktywne przez dłuższy czas
- Zasoby systemowe są ograniczone
- Wiele aplikacji konkuruje o czas wykonania w tle
Obsługuje tylko typ danych Health Metrics
Tylko format JSON (nie można zmienić)

Wymagania wstępne

Instancja Home Assistant działająca i dostępna w sieci
Token dostępu do interfejsu API Home Assistant (Token dostępu długoterminowy)
Łączność sieciowa z instancją Home Assistant
Wersja Home Assistant obsługująca interfejs API REST

Konfiguracja

Przejdź do ekranu Zautomatyzowane eksporty z głównej nawigacji, następnie dotknij "Nowa automatyzacja" i wybierz "Home Assistant" jako Typ automatyzacji.

Nazwa automatyzacji

Wprowadź opisową nazwę automatyzacji. Ta nazwa zostanie użyta do wygenerowania identyfikatora encji czujnika w Home Assistant.

Uwaga: Nazwa automatyzacji zostanie przekonwertowana na małe litery z usuniętymi spacjami, aby utworzyć identyfikator encji. Na przykład "Moje dane zdrowotne" staje się hae.mojedanezdrowotne.

Powiadomienia

Skonfiguruj, kiedy chcesz otrzymywać powiadomienia:

Powiadamiaj o aktualizacji cache - Otrzymuj powiadomienie, gdy dane w pamięci podręcznej są aktualizowane
Powiadamiaj przy uruchomieniu - Otrzymuj powiadomienie za każdym razem, gdy automatyzacja jest wykonywana

URL Home Assistant

Wprowadź podstawowy URL instancji Home Assistant. Powinien zawierać protokół i port, jeśli nie używasz domyślnego.

Przykładowe URL:

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

Uwaga: URL musi być dostępny z Twojego urządzenia. Jeśli używasz HTTPS, upewnij się, że certyfikat jest ważny lub dodaj wyjątek.

Automatycznie generowany punkt końcowy

Aplikacja automatycznie generuje pełny punkt końcowy interfejsu API na podstawie nazwy automatyzacji:

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

Na przykład, jeśli Twój URL to http://homeassistant.local:8123 i nazwa automatyzacji to "Metryki zdrowotne", punkt końcowy będzie:

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

Ten punkt końcowy jest wyświetlany pod polem URL jako odniesienie.

Limit czasu żądania

Wybierz interwał limitu czasu dla żądań HTTP do Home Assistant.

Dostępne opcje limitu czasu:

60 sekund - Domyślne, odpowiednie dla większości instancji Home Assistant
300 sekund (5 minut) - Dla wolniejszych instancji Home Assistant
1800 sekund (30 minut) - Dla bardzo wolnego przetwarzania
3600 sekund (1 godzina) - Maksymalny zalecany limit czasu

Nagłówki HTTP

Dodaj nagłówki uwierzytelniania dla dostępu do interfejsu API Home Assistant. Musisz dodać nagłówek Authorization z tokenem dostępu długoterminowym.

Wymagany nagłówek:

Authorization: Bearer YOUR_LONG_LIVED_ACCESS_TOKEN

Aby uzyskać token dostępu długoterminowy:

Otwórz Home Assistant
Przejdź do swojego profilu (kliknij swoje imię w lewym dolnym rogu)
Przewiń w dół do "Tokeny dostępu długoterminowego"
Kliknij "Utwórz token"
Nadaj mu nazwę (np. "Health Auto Export")
Skopiuj token i wklej go w polu wartości nagłówka

Opcjonalne nagłówki:
Możesz dodać dodatkowe nagłówki, jeśli jest to konieczne dla konfiguracji Home Assistant.

Aby dodać nagłówki:

Dotknij "Dodaj nagłówki"
Wprowadź klucz nagłówka w lewym polu
Wprowadź wartość nagłówka w prawym polu
Powtórz dla dodatkowych nagłówków

Ważne: Każdy klucz nagłówka musi mieć odpowiadającą wartość. Puste nagłówki będą ignorowane.

Ustawienia typu danych

Typ danych

Uwaga: Automatyzacje Home Assistant obsługują tylko typ danych Health Metrics. To ustawienie nie może być zmienione i jest automatycznie ustawione na Health Metrics.

Konfiguracja Health Metrics

Wybierz Health Metrics - Wybierz, które konkretne metryki uwzględnić. Możesz wybrać wszystkie dostępne metryki lub wybrać konkretne.

Wskazówka: Wybranie tylko potrzebnych metryk może poprawić czas przetwarzania i zmniejszyć rozmiar danych wysyłanych do Home Assistant.

Preferowane źródła - Skonfiguruj, które źródła danych mają priorytet, gdy wiele źródeł dostarcza tę samą metrykę.

Ustawienia eksportu

Format eksportu

Uwaga: Automatyzacje Home Assistant obsługują tylko format JSON. To ustawienie nie może być zmienione i jest automatycznie ustawione na JSON.

Wersja eksportu

Uwaga: Wersja eksportu nie jest dostępna dla automatyzacji Home Assistant, ponieważ format jest zoptymalizowany specjalnie dla interfejsu API stanu Home Assistant.

Zakres dat

Wybierz, kiedy dane powinny być eksportowane:

Domyślne - Synchronizuje dane dla pełnego poprzedniego dnia plus dane do aktualnej daty i godziny
Dzisiaj - Synchronizuje wszystkie dane dla aktualnej daty do aktualnej godziny
Wczoraj - Synchronizuje wszystkie dane dla pełnego poprzedniego dnia

Uwaga: Automatyzacje Home Assistant nie obsługują opcji "Czas rzeczywisty", "Od ostatniej synchronizacji" lub "Ostatnie 7 dni".

Podsumuj dane

Włącz lub wyłącz Podsumuj dane dla Health Metrics.

WŁĄCZONE - Zapewnia zagregowane podsumowania danych (domyślne)
WYŁĄCZONE - Zapewnia zdezagregowane dane, gdy to możliwe

Uwaga: To ustawienie dotyczy tylko typu danych Health Metrics.

Grupowanie czasowe

Gdy Podsumuj dane jest włączone, wybierz, jak dane powinny być agregowane:

Domyślne - Brak agregacji, surowe punkty danych
Dni - Grupuje dane według dni (zalecane)

Częstotliwość synchronizacji

Skonfiguruj, jak często automatyzacja powinna synchronizować dane z Home Assistant:

Wybierz liczbę i interwał.

Testowanie i weryfikacja

Testy ręczne

Dotknij "Eksport ręczny" na ekranie konfiguracji automatyzacji
Wybierz zakres dat
Dotknij "Eksportuj", aby wysłać żądanie testowe
Sprawdź w Home Assistant, czy stan czujnika został utworzony/zaktualizowany

Weryfikacja w Home Assistant

Otwórz Home Assistant
Przejdź do Narzędzia deweloperskie > Stany
Wyszukaj hae.{your_automation_name} (małe litery, bez spacji)
Zweryfikuj, czy stan czujnika pokazuje Twoje dane zdrowotne
Sprawdź znacznik czasu "Ostatnia aktualizacja", aby potwierdzić niedawne synchronizacje

Przeglądanie dzienników aktywności

Dotknij "Wyświetl dzienniki aktywności" na ekranie konfiguracji automatyzacji
Przejrzyj niedawne uruchomienia automatyzacji
Sprawdź błędy lub ostrzeżenia
Zweryfikuj znaczniki czasu żądań i status odpowiedzi

Sprawdzanie dzienników Home Assistant

Jeśli dane nie pojawiają się w Home Assistant:

Otwórz Home Assistant
Przejdź do Ustawienia > System > Dzienniki
Szukaj błędów związanych z interfejsem API REST lub stanami czujników
Sprawdź błędy uwierzytelniania lub nieprawidłowy format danych

Rozwiązywanie problemów

Typowe problemy

Błędy uwierzytelniania

Zweryfikuj, czy token dostępu długoterminowy jest poprawny
Upewnij się, że nagłówek Authorization jest sformatowany jako: Bearer YOUR_TOKEN
Sprawdź, czy token nie wygasł lub nie został odwołany
Zweryfikuj, czy token ma odpowiednie uprawnienia w Home Assistant

Czujnik nie pojawia się w Home Assistant

Sprawdź, czy nazwa automatyzacji nie zawiera znaków specjalnych
Zweryfikuj format identyfikatora encji: hae.{automation_name} (małe litery, bez spacji)
Sprawdź dzienniki Home Assistant pod kątem błędów
Upewnij się, że żądanie interfejsu API zakończyło się sukcesem (sprawdź Dzienniki aktywności)

Dane nie są aktualizowane

Sprawdź, czy automatyzacja jest włączona
Przejrzyj Dzienniki aktywności pod kątem błędów
Upewnij się o łączności sieciowej z Home Assistant

Limit czasu połączenia

Zweryfikuj, czy Home Assistant działa i jest dostępny
Sprawdź łączność sieciową
Zwiększ ustawienie Limitu czasu żądania, jeśli Home Assistant odpowiada wolno
Zweryfikuj, czy URL i port są poprawne

Komunikaty błędów

Aplikacja wyświetli komunikaty błędów, jeśli:

URL jest nieprawidłowy lub niedostępny
Uwierzytelnianie nie powiodło się (sprawdź nagłówek Authorization)
Home Assistant zwraca kod statusu błędu
Łączność sieciowa jest niedostępna

Sprawdź Dzienniki aktywności, aby uzyskać szczegółowe informacje o błędach, w tym kody statusu HTTP i komunikaty błędów z Home Assistant.

Wskazówki dotyczące integracji Home Assistant

Używanie danych zdrowotnych w automatyzacjach

Gdy Twoje dane zdrowotne są zsynchronizowane z Home Assistant, możesz używać ich w automatyzacjach:

automation:
  - alias: "Dobra jakość snu"
    trigger:
      - platform: numeric_state
        entity_id: sensor.hae_myhealthdata_sleep_total
        above: 7
    action:
      - service: notify.mobile_app_your_phone
        data:
          message: "Świetny sen zeszłej nocy!"

Tworzenie paneli

Dodaj metryki zdrowotne do panelu Home Assistant:

Przejdź do panelu
Dodaj nową kartę
Wybierz typ karty "Encje" lub "Gauge"
Dodaj encje czujników hae.{your_automation_name}

Struktura stanu czujnika

Stan czujnika w Home Assistant zawiera:

state: Aktualna wartość lub status
attributes: Dodatkowe dane, w tym:
- Informacje o znaczniku czasu
- Struktura danych odpowiadająca wyeksportowanemu formatowi JSON
- Informacje o jednostkach, gdy dotyczy

Wskazówki i najlepsze praktyki

Nazewnictwo:
- Unikaj znaków specjalnych, które mogą powodować problemy
Wybór danych:
- Wybierz tylko potrzebne metryki