Synchronizuj dane Apple Health z REST API
Wysyłaj dane zdrowotne do punktu końcowego REST API.
Ostatnia aktualizacja: 31 października 2026
Na tej stronie
Ustawienia eksportu
Ustawienia eksportu Format eksportuWersja eksportuZakres datSumuj dane i grupowanie czasuWysyłaj eksporty zdrowia do punktu końcowego, który akceptuje żądania HTTP POST.
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 udane przesłanie do Twojego punktu końcowego.
Zezwól na powiadomienia, gdy zostaniesz o to poproszony. Te powiadomienia zgłaszają aktywność; nie planują uruchomienia.
Skonfiguruj punkt końcowy
- Wybierz REST API jako Typ automatyzacji.
- Podaj URL osiągalny z iPhone’a lub iPada, na przykład
https://api.example.com/health-data. - Dodaj wymagane uwierzytelnianie w Nagłówki HTTP. Na przykład użyj
Authorizationjako klucza iBearer YOUR_TOKENjako wartości. - Wybierz Limit czasu żądania odpowiedni dla Twojego punktu końcowego.
Każdy nagłówek wymaga zarówno klucza, jak i wartości. Dla serwera na innym urządzeniu użyj jego osiągalnego adresu sieciowego zamiast localhost.
Ustawienia typu danych
Wybierz jeden Typ danych dla tej automatyzacji: Metryki zdrowia, Treningi, Objawy, EKG, Powiadomienia o tętnie, Stan umysłu, Śledzenie cyklu lub Leki. Stan umysłu wymaga iOS 18 lub nowszego; Leki wymagają iOS 26 lub nowszego oraz osobnego dostępu do leków.
Metryki zdrowia
Wybierz Metryki zdrowia, a następnie otwórz Wybierz metryki zdrowia i wybierz potrzebne pomiary.
Aby ograniczyć odczyty do konkretnych aplikacji lub urządzeń, otwórz Preferowane źródła, wybierz metrykę i wybierz jej źródła. Wszystkie zezwala na każde źródło, które nie zostało wykluczone. Użyj Wykluczone źródła, aby ignorować źródło we wszystkich metrykach zdrowia tej automatyzacji. Wykluczenia mają pierwszeństwo; niewybrane źródło nie jest podstawiane, gdy preferowane źródło nie ma danych. Wybierz Zapisz, aby zastosować wybór źródeł, albo Anuluj, aby go odrzucić.
Treningi
Wybierz Treningi, aby eksportować rekordy treningów. Uwzględnij dane trasy dodaje dostępne punkty trasy do danych treningu JSON. Nie tworzy osobnych przesłań GPX.
Dla Wersji 2 włącz Uwzględnij metryki treningu, aby dodać odczyty takie jak tętno, aktywna energia i kroki. Wybierz Minuty lub Sekundy dla Grupowania czasu metryk treningu; sekundy dają więcej szczegółów i większe eksporty. Wersja 1 zawsze uwzględnia metryki treningu.
Ustawienia eksportu
Format eksportu
- JSON zachowuje ustrukturyzowane dane na potrzeby integracji i analizy.
- CSV tworzy pliki tabelaryczne do arkuszy kalkulacyjnych.
- Markdown tworzy czytelne nagłówki i tabele do notatek i archiwów.
Wersja eksportu
Wybierz Wersję 2 dla bieżącej struktury danych. Użyj Wersji 1, gdy istniejący przepływ pracy zależy od starszego formatu.
Zakres dat
| Wybór | Uwzględnione dane |
|---|---|
| Domyślny | Poprzedni dzień oraz dziś do chwili uruchomienia |
| Od ostatniej synchronizacji | Od poprzedniej synchronizacji do chwili uruchomienia |
| Dziś | Dziś do chwili uruchomienia |
| Wczoraj | Poprzedni pełny dzień |
| Poprzednie 7 dni | Poprzednie siedem pełnych dni |
Sumuj dane i grupowanie czasu
Dla JSON + Metryki zdrowia włącz Sumuj dane, aby łączyć odczyty w grupy czasu, albo wyłącz, aby uzyskać poszczególne odczyty, gdy są dostępne. Podsumowanie zależy od metryki — na przykład kroki są sumowane, a odczyty wagi uśredniane. Eksporty CSV metryk zdrowia używają danych zsumowanych.
Gdy dostępne jest Grupowanie czasu, wybierz, ile szczegółów zachować. Grupy godzinowe lub dzienne dają mniej wierszy niż minutowe lub sekundowe. Dostępne wybory zależą od zakresu dat i formatu. Grupowanie czasu treningów konfiguruje się osobno w Treningach.
Żądania wsadowe i duże ładunki
Dla REST API + JSON włącz Żądania wsadowe, aby wysyłać dane w wielu żądaniach. Użyj tego, gdy punkt końcowy odrzuca duże treści lub duże żądania przekraczają limit czasu. Usługa odbierająca musi obsługiwać każde żądanie osobno.
Grupowanie wsadowe jest niedostępne dla CSV i Markdown. Zmniejsza rozmiar poszczególnych żądań, ale nie zmniejsza ilości danych zdrowotnych, które urządzenie musi odczytać. Zobacz Wydajność, jeśli przygotowanie jest wolne.
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, Godziny, Dni lub Tygodnie w Częstotliwość synchronizacji — na przykład co 15 minut. 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.
Nagłówki żądania
Aplikacja ustawia Content-Type dla wybranego formatu i dołącza:
| Nagłówek | Znaczenie |
|---|---|
automation-name |
Nazwa automatyzacji |
automation-id |
Identyfikator automatyzacji |
automation-aggregation |
Wybrane grupowanie czasu |
automation-period |
Wybrany zakres dat |
session-id |
Identyfikator żądania |
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.
- Sprawdź otrzymane żądanie, nagłówki i treść w punkcie końcowym.
Rozwiązywanie problemów
- Nie odebrano żądania: Sprawdź URL, dostępność sieci i dzienniki serwera.
- Błąd uwierzytelniania: Sprawdź klucz nagłówka, token i uprawnienia punktu końcowego.
- Ładunek odrzucony lub przekroczono limit czasu: Sprawdź limity rozmiaru serwera, użyj grupowania wsadowego dla JSON albo zmniejsz rozmiar eksportu.
Otwórz automatyzację i wybierz Pokaż dzienniki aktywności, aby przejrzeć uruchomienie. Ostrzeżenia oznaczają potencjalne problemy, takie jak wolne pobieranie danych; błędy identyfikują nieudane kroki. W sprawie zgłoszenia problemu zobacz Uzyskaj pomoc.