Synchronizuj dane Apple Health z Home Assistant
Zintegruj dane zdrowotne z Home Assistant.
Ostatnia aktualizacja: 31 października 2026
Na tej stronie
Publikuj metryki zdrowia w Home Assistant jako osobne stany encji. To miejsce docelowe obsługuje wyłącznie metryki zdrowia.
Ważne — ograniczenia automatyzacji: Urządzenie musi być odblokowane, aby odczytać dane zdrowotne, a iOS nie gwarantuje uruchomień w tle z wybraną częstotliwością. Przejrzyj Ograniczenia automatyzacji, zanim polegiesz na automatycznych eksportach.
Otwórz automatyzację
Otwórz Eksport → Automatyczne na iPhonie albo Automatyzacje w pasku bocznym iPada. Wybierz Nowa automatyzacja albo otwórz istniejącą, aby ją edytować.
Nazwa, stan i powiadomienia
Podaj nazwę identyfikującą tę automatyzację. Włączone zezwala na automatyczne uruchomienia; zostaw wyłączone, aż będziesz gotowy.
Wybierz powiadomienia o uruchomieniu, których chcesz:
- Powiadom przy aktualizacji pamięci podręcznej zgłasza, że dane eksportu zostały przygotowane.
- Powiadom po uruchomieniu zgłasza udaną publikację w Home Assistant.
Zezwól na powiadomienia, gdy zostaniesz o to poproszony. Te powiadomienia zgłaszają aktywność; nie planują uruchomienia.
Połącz Home Assistant
- Wybierz Home Assistant jako Typ automatyzacji.
- Podaj bazowy URL instancji Home Assistant, na przykład
http://homeassistant.local:8123. - Utwórz Long-Lived Access Token w profilu Home Assistant.
- W Nagłówki HTTP dodaj
Authorizationz wartościąBearer YOUR_LONG_LIVED_ACCESS_TOKEN.
Twoja instancja Home Assistant musi być osiągalna z iPhone’a lub iPada. W przypadku HTTPS użyj certyfikatu, któremu urządzenie ufa.
Ustawienia metryk zdrowia
Otwórz Wybierz metryki zdrowia i wybierz odczyty do publikacji.
Otwórz Preferowane źródła, aby wybrać źródła dla każdej metryki. Użyj Wszystkie dla wszystkich niewykluczonych źródeł albo Wykluczone źródła, aby ignorować źródło w tej automatyzacji. Wykluczenia mają pierwszeństwo, a niewybrane źródła nie zastępują preferowanego źródła bez danych. Wybierz Zapisz, aby zastosować wybór, albo Anuluj, aby go odrzucić.
Ustawienia eksportu
Home Assistant używa własnego formatu stanu encji JSON; nie ma wyboru formatu pliku ani wersji eksportu.
Zakres dat
- Domyślny: Obejmuje poprzedni dzień oraz dziś do chwili uruchomienia.
- Dziś: Obejmuje dziś do chwili uruchomienia.
- Wczoraj: Obejmuje poprzedni pełny dzień.
Grupowanie czasu
Wybierz Domyślny, aby zachować odczyty bez grupowania, albo Dni dla dziennych podsumowań. Home Assistant nie ma przełącznika Sumuj dane.
Planuj przypomnienia
Jeśli chcesz monitu o odblokowanie i otwarcie aplikacji, włącz Włącz przypomnienia. Wybierz Co godzinę, Codziennie lub Wybrane dni, a następnie ustaw minutę, godzinę i dni stosownie do potrzeby. Zezwól na dostęp do powiadomień, gdy zostaniesz o to poproszony; jeśli dostęp zostanie odrzucony, użyj Otwórz ustawienia powiadomień.
Przypomnienie nie uruchamia automatyzacji ani nie potwierdza udanej synchronizacji. Stuknij je, aby otworzyć automatyzację, albo użyj Otwórz i synchronizuj na powiadomieniu, aby zażądać uruchomienia. Automatyzacja musi być włączona; przypomnienie może nadal się pojawić po udanym uruchomieniu w tle. Zmiany przypomnień obowiązują przy zapisie.
Częstotliwość synchronizacji i zapis
Wybierz liczbę oraz Minuty lub Godziny w Częstotliwość synchronizacji. To żądana kadencja w tle, a nie gwarantowany harmonogram.
Urządzenie musi być odblokowane podczas odczytu danych zdrowotnych. Włącz Odświeżanie aplikacji w tle dla Health Auto Export i wyłącz tryb niskiego zużycia energii na potrzeby automatycznych uruchomień. iOS może nadal opóźniać uruchomienia, gdy urządzenie było nieaktywne lub zasoby systemowe są ograniczone.
Włącz Włączone, gdy będziesz gotowy na automatyczne uruchomienia, a następnie wybierz Aktualizuj, aby zapisać automatyzację. Możesz od razu przesłać wybrany zakres dat, korzystając z kroków poniżej.
Opublikowane encje
Każda wybrana metryka może utworzyć jedną lub więcej encji. Identyfikator zaczyna się od hae., po nim następuje nazwa automatyzacji małymi literami bez spacji, a następnie metryka i ewentualna nazwa komponentu.
Na przykład automatyzacja o nazwie Health Metrics może publikować kroki pod adresem:
http://homeassistant.local:8123/api/states/hae.healthmetrics_step_count
Stan to najnowszy odczyt dla wybranego dnia z atrybutami jednostki miary. Metryki takie jak ciśnienie krwi i tętno używają osobnych encji komponentów.
Gdy dzień nie ma danych, sumy takie jak kroki i godziny stania publikują 0. Inne odczyty, takie jak waga lub tętno, nie są aktualizowane, dopóki nie ma danych, więc Home Assistant może nadal pokazywać ostatnią otrzymaną wartość. Wczesnym rankiem sumy mogą pozostać 0, aż dane z Watch dotrą do iPhone’a.
Eksportuj dane historyczne lub pominięte
Użyj Przesyłanie ręczne, gdy po raz pierwszy konfigurujesz automatyzację, aby wyeksportować dane historyczne, albo później, aby uzupełnić daty pominięte przez automatyczną synchronizację. Możesz też użyć tego, aby sprawdzić konfigurację.
- Otwórz automatyzację i wybierz Przesyłanie ręczne w Eksportuj istniejące dane.
- Ustaw daty Początek i Koniec, a następnie wybierz Rozpocznij eksport.
- W Home Assistant otwórz Narzędzia deweloperskie → Stany i wyszukaj prefiks
hae.swojej automatyzacji. - Sprawdź wartości encji i czasy aktualizacji.
Rozwiązywanie problemów
- Błąd uwierzytelniania: Sprawdź token i nagłówek
Authorization: Bearer .... - Połączenie nie powiodło się: Sprawdź bazowy URL, port, dostęp do sieci i zaufanie do certyfikatu.
- Brakuje niektórych odczytów: Przejrzyj wybrany dzień, źródła i dzienniki aktywności. Uruchomienie może zaktualizować niektóre encje, podczas gdy inne się nie powiodą.
Otwórz automatyzację i wybierz Pokaż dzienniki aktywności, aby sprawdzić nieudane kroki. W sprawie wsparcia zobacz Uzyskaj pomoc.