Synchronizuj dane Apple Health z REST API

Automatyzacje REST API umożliwiają automatyczne eksportowanie danych zdrowotnych do dowolnej usługi internetowej, która akceptuje żądania HTTP POST. Jest to idealne rozwiązanie do integracji z niestandardowymi backendami, API stron trzecich lub webhookami.

Przegląd

Automatyzacje REST API wysyłają dane zdrowotne do określonego endpointu URL za pomocą żądań HTTP POST. Automatyzacja może wysyłać dane w formacie JSON lub CSV, z konfigurowalnymi nagłówkami do uwierzytelniania i niestandardowymi metadanymi.

Przypadki użycia:

• Integracja z niestandardowymi usługami backendowymi
• Wysyłanie danych do webhooków
• Synchronizacja z API stron trzecich
• Tworzenie niestandardowych pulpitów nawigacyjnych lub platform analitycznych

Kluczowe funkcje:

• Obsługuje formaty JSON i CSV
• Niestandardowe nagłówki HTTP do uwierzytelniania
• Konfigurowalny limit czasu żądania
• Ręczny eksport danych historycznych

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 niskiego zużycia energii
  • Urządzenie było nieaktywne przez dłuższy czas
  • Zasoby systemowe są ograniczone
  • Wiele aplikacji konkuruje o czas wykonywania w tle

Wymagania wstępne

• Ważny endpoint URL, który akceptuje żądania HTTP POST
• Dane uwierzytelniające (jeśli wymagane przez endpoint)
• Łączność sieciowa, aby dotrzeć do endpointu

Konfiguracja

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

Nazwa automatyzacji

Wprowadź opisową nazwę automatyzacji (np. "Moje API backend", "Integracja webhook").

Powiadomienia

Skonfiguruj, kiedy chcesz otrzymywać powiadomienia:

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

Konfiguracja URL

Wprowadź pełny adres URL, gdzie chcesz wysłać dane zdrowotne. Powinien to być pełny adres URL, w tym protokół (http:// lub https://).

Przykładowe adresy URL:

• https://api.example.com/health-data
• https://webhook.site/your-unique-id
• http://localhost:3000/api/health

Uwaga: Adres URL musi być prawidłowy i dostępny z urządzenia. Nieprawidłowe adresy URL uniemożliwią działanie automatyzacji.

Limit czasu żądania

Wybierz interwał limitu czasu dla żądań HTTP. Określa to, jak długo aplikacja będzie czekać na odpowiedź, zanim uzna żądanie za nieudane.

Nagłówki HTTP

Dodaj niestandardowe nagłówki HTTP do uwierzytelniania lub metadanych. Typowe przypadki użycia obejmują:

• Klucze API: X-API-Key: your-api-key
• Tokeny autoryzacji: Authorization: Bearer your-token
• Nadpisy typu zawartości: Content-Type: application/json

Aby dodać nagłówki:

1. Dotknij "Dodaj nagłówki"
2. Wprowadź klucz nagłówka w lewym polu
3. Wprowadź wartość nagłówka w prawym polu
4. 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

Wybierz, jaki typ danych zdrowotnych eksportować:

• Metryki zdrowia - Kroki, tętno, sen i inne pomiary zdrowotne
• Treningi - Ćwiczenia i aktywności fitness
• Objawy - Objawy i stany zdrowotne
• EKG - Odczyty elektrokardiogramu
• Powiadomienia o tętnie - Zdarzenia wysokiego/niskiego tętna
• Stan umysłu - Wpisy dotyczące nastroju i stanu psychicznego (iOS 18.0+)
• Śledzenie cyklu - Dane dotyczące cyklu miesiączkowego i zdrowia reprodukcyjnego
• Leki - Dzienniki leków i przestrzeganie (iOS 26.0+)

Konfiguracja metryk zdrowia

Gdy wybrano Metryki zdrowia:

Wybierz metryki zdrowia - 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.

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

Konfiguracja treningów

Gdy wybrano Treningi:

Uwzględnij dane trasy - Włącz, aby uwzględnić trasy dla treningów, które mają dane lokalizacji.

Uwzględnij metryki treningu - Włącz, aby uwzględnić metryki zdrowia zebrane podczas treningów (tętno, kalorie itp.).

Grupowanie czasu (metryki treningu) - Podczas używania Wersji eksportu 2 i gdy Uwzględnij metryki treningu jest włączone:

• Minuty - Grupuje metryki treningu według minuty
• Sekundy - Grupuje metryki treningu według sekundy

Ustawienia eksportu

Format eksportu

Wybierz format eksportowanych danych:

• Format JSON - Zapewnia szczegółowe struktury danych z zagnieżdżonymi obiektami. Najlepsze dla API, baz danych i aplikacji, które potrzebują danych strukturalnych. Format JSON zawiera bardziej szczegółowe informacje dla złożonych typów danych, takich jak fazy snu i odczyty AFib.

• Format CSV - Zapewnia dane tabelaryczne, które można łatwo zaimportować do aplikacji arkuszy kalkulacyjnych. Najlepsze dla prostej analizy danych lub gdy endpoint oczekuje danych CSV.

Uwaga: Nagłówek Content-Type jest automatycznie ustawiany na application/json dla eksportów JSON i multipart/form-data dla eksportów CSV.

Wersja eksportu

Wybierz Wersję eksportu. Wersjonowanie pozwala przejść między zaktualizowanymi wersjami eksportu we własnym tempie i minimalizuje zmiany, które przerywają przepływy pracy.

• Wersja 1 - Format starszy, użyj, jeśli masz istniejące przepływy pracy zależne od tego formatu
• Wersja 2 - Format bieżący z ulepszonymi danymi treningu i bardziej szczegółowymi opcjami metadanych

Zakres dat

Wybierz, kiedy dane powinny być eksportowane:

• Domyślne - Synchronizuje dane dla pełnego poprzedniego dnia plus dane do bieżącej daty i godziny
• Od ostatniej synchronizacji - Przy każdej synchronizacji eksportuje wszystkie dane od ostatniego uruchomienia eksportu do bieżącej daty i godziny
• Dzisiaj - Synchronizuje wszystkie dane dla bieżącej daty do bieżącej godziny
• Wczoraj - Synchronizuje wszystkie dane dla pełnego poprzedniego dnia
• Ostatnie 7 dni - Synchronizuje dane dla pełnych ostatnich siedmiu dni

Podsumuj dane

Podczas używania formatu JSON z typem danych Metryki zdrowia, włącz lub wyłącz Podsumuj dane.

• WŁĄCZONE - Zapewnia zagregowane podsumowania danych
• WYŁĄCZONE - Zapewnia zdezagregowane dane, gdy to możliwe, pokazując indywidualne punkty danych

Uwaga: To ustawienie dotyczy tylko formatu JSON z Metrykami zdrowia. Dane są zawsze agregowane podczas używania formatu CSV lub gdy wybrano wiele metryk.

Grupowanie czasu

Podczas używania formatu JSON z włączonym Podsumuj dane, wybierz, jak dane powinny być agregowane.

Uwaga: Format CSV zawsze agreguje dane. Agregacja na poziomie minuty i sekundy może znacznie zwiększyć czas przetwarzania i rozmiar danych.

Żądania wsadowe

Podczas używania formatu JSON, włącz Żądania wsadowe, aby wysyłać dane w partiach przez wiele żądań zamiast jednego ładunku.

• WŁĄCZONE - Rozkłada dane na wiele żądań, aby uniknąć nadmiernie dużych ładunków
• WYŁĄCZONE - Wysyła wszystkie dane w jednym żądaniu

Częstotliwość synchronizacji

Skonfiguruj, jak często automatyzacja powinna przesyłać dane:

Wybierz liczbę i interwał.

Testowanie i weryfikacja

Testowanie ręczne

1. Dotknij "Eksport ręczny" na ekranie konfiguracji automatyzacji
2. Wybierz zakres dat
3. Dotknij "Eksportuj", aby wysłać żądanie testowe
4. Sprawdź endpoint, aby potwierdzić, że dane zostały odebrane

Przeglądanie dzienników aktywności

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

Weryfikacja formatu danych

Aplikacja automatycznie uwzględnia te nagłówki w każdym żądaniu:

• Content-Type - Ustawiony na podstawie formatu eksportu
• automation-name - Nazwa automatyzacji
• automation-id - Unikalny identyfikator automatyzacji
• automation-aggregation - Wybrane grupowanie czasu
• automation-period - Wybrany zakres dat
• session-id - Unikalny identyfikator dla każdego żądania

Rozwiązywanie problemów

Typowe problemy

Dane nie zostały odebrane w endpoincie

• Zweryfikuj, czy adres URL endpointu jest prawidłowy
• Sprawdź, czy endpoint akceptuje żądania POST
• Przejrzyj nagłówki uwierzytelniania
• Sprawdź dzienniki endpointu pod kątem przychodzących żądań
• Zweryfikuj łączność sieciową

Wskazówki i najlepsze praktyki

1. Wydajność:

   • Użyj odpowiedniego grupowania czasu, aby zrównoważyć szczegółowość a rozmiar danych
   • Wybierz tylko potrzebne metryki

2. Niezawodność:

   • Ustaw odpowiednie wartości limitu czasu na podstawie czasu odpowiedzi endpointu
   • Regularnie monitoruj dzienniki aktywności

3. Format danych:

   • Użyj JSON dla danych strukturalnych i API
   • Użyj CSV dla prostej analizy danych lub integracji z arkuszami kalkulacyjnymi
   • Rozważ żądania wsadowe dla dużych zestawów danych lub oddzielnego przetwarzania