Centrum pomocy HealthyApps
Polski
Centrum pomocy
Strona główna ↗

Szukaj tematów pomocy

Automatyzacja Deep Link

Utwórz automatyzację REST API, otwierając URL na iPhonie lub iPadzie.

Ostatnia aktualizacja: 31 października 2026

Na tej stronie
Format URL
Referencja parametrów Referencja parametrów Podstawowe ustawieniaMetryki zdrowiaTreningiKadencja i powiadomienia
Uwierzytelnianie i kodowanie
Przykłady Przykłady Wybrane metryki, sumowane godzinowoTreningi z trasami
Rozwiązywanie problemówPowiązana dokumentacja

Utwórz automatyzację REST API, otwierając URL na iPhonie lub iPadzie. Deep linki nie konfigurują innych miejsc docelowych.

Format URL

com.HealthExport://automation?url=https%3A%2F%2Fapi.example.com%2Fhealth&name=Daily%20Export

url jest wymagany. Podaj opisową wartość name; jeśli ją pomnisz, domyślnie jest Automation. Nazwy parametrów nie rozróżniają wielkości liter. Koduj URL wartości parametrów zawierające spacje lub znaki zastrzeżone.

Otwórz URL na urządzeniu albo użyj Otwórz adresy URL w Skrótach. Przed włączeniem przejrzyj utworzoną automatyzację w Health Auto Export.

Referencja parametrów

Wartości logiczne przyjmują true/false, 1/0 lub yes/no. Ustaw datatype przed jego opcjami specyficznymi dla danych oraz format przed aggregatedata, aby późniejsze wybory nie zastępowały wcześniejszych ustawień.

Podstawowe ustawienia

Parametr Wartości lub znaczenie Domyślnie
url URL punktu końcowego osiągalny z urządzenia Wymagany
name Niepusta nazwa automatyzacji Automation
enabled Włącz automatyczne uruchomienia false
datatype Typ danych wymieniony poniżej healthMetrics
format json, csv, markdown lub md json
exportversion v1, v2, 1 lub 2 v2
period none, lastsync, today, yesterday, previous7days none
requesttimeout Liczba całkowita sekund, 60–86400 60
headers Pary klucz/wartość rozdzielone przecinkami Brak
batchrequests Wartość logiczna; tylko JSON false

Prawidłowe typy danych to healthMetrics, workouts, symptoms, ecg, heartRateNotification, stateOfMind, cycleTracking i medications. Stan umysłu wymaga iOS 18 lub nowszego; eksporty leków wymagają iOS 26 lub nowszego.

Znaczenia zakresów dat zobacz w Zakres dat. Wszystkie deep linki tworzą automatyzacje REST API; nie ma parametru exportDestination.

Metryki zdrowia

Parametr Wartości lub znaczenie Domyślnie
metrics Dokładne nazwy metryk rozdzielone przecinkami, na przykład Step Count,Heart Rate Wszystkie dostępne metryki
aggregatedata Wartość logiczna; użyj false dla poszczególnych odczytów, gdy jest to obsługiwane true
interval none, minutes, hours, days, weeks, months, years none
aggregatesleep Wartość logiczna sterująca sumowaniem snu true

metrics, aggregatedata i interval dotyczą metryk zdrowia. Wybór CSV włącza sumowanie; użyj JSON dla poszczególnych odczytów. Przy generowaniu linków jawnie określ żądane sumowanie.

Treningi

Parametr Wartości lub znaczenie Domyślnie gdy datatype=workouts
includeroutes Wartość logiczna true
includeworkoutmetadata Wartość logiczna true
workoutsmetadatainterval minutes lub seconds; Wersja 2 minutes
workouttypes Bezpieczne identyfikatory typów treningów Apple rozdzielone przecinkami Wszystkie typy

Nie dołączaj opcji agregacji metryk zdrowia w linku treningu.

Kadencja i powiadomienia

Parametr Wartości lub znaczenie Domyślnie
syncinterval minutes, hours, days, weeks minutes
syncquantity Dodatnia liczba całkowita interwałów 5
notifyonupdate Wartość logiczna; powiadom po przygotowaniu danych true
notifywhenrun Wartość logiczna; powiadom po udanej akcji w miejscu docelowym true

Kadencja nadal podlega ograniczeniom tła i danych zdrowotnych; nie jest dokładnym harmonogramem.

Uwierzytelnianie i kodowanie

Wartość headers składa się z naprzemiennych kluczy i wartości:

headers=Authorization,Bearer%20YOUR_TOKEN,X-API-Key,YOUR_KEY

Każdy klucz wymaga wartości. Przecinki rozdzielają pary, więc unikaj wartości nagłówków zawierających przecinki w tym formacie linku. Koduj spacje jako %20, znaki plus jako %2B, a ampersandy jako %26. Zakoduj pełny URL punktu końcowego, gdy ma własne parametry zapytania.

Przykłady

Wybrane metryki, sumowane godzinowo

com.HealthExport://automation?url=https%3A%2F%2Fapi.example.com%2Fmetrics&name=Steps%20and%20Heart%20Rate&datatype=healthMetrics&format=json&metrics=Step%20Count,Heart%20Rate&aggregatedata=true&interval=hours

Treningi z trasami

com.HealthExport://automation?url=https%3A%2F%2Fapi.example.com%2Fworkouts&name=Workout%20Export&datatype=workouts&format=json&includeroutes=true&includeworkoutmetadata=true&exportversion=v2&workoutsmetadatainterval=minutes

Oba przykłady pozostawiają automatyczne uruchomienia wyłączone, aż przejrzysz i włączysz automatyzację.

Rozwiązywanie problemów

  • Błąd URL lub parametru: Zacznij od minimalnego URL, sprawdź pisownię i kodowanie, a następnie dodawaj opcje pojedynczo.
  • Nieprawidłowa metryka: Użyj dokładnej nazwy metryki, włącznie ze spacjami i wielkością liter.
  • Błąd agregacji: Używaj opcji metryk zdrowia tylko z datatype=healthMetrics.
  • Błąd ustawień treningu: Używaj opcji treningu z datatype=workouts; grupowanie sekundowe wymaga Wersji 2.
  • Błąd grupowania wsadowego: Ustaw format=json albo wyłącz batchrequests.
  • Nieprawidłowa kadencja/limit czasu: Użyj obsługiwanych interwałów, dodatniej ilości i limitu czasu od 60 do 86400 sekund.
  • URL za długi: Zmniejsz listę metryk/nagłówków albo skonfiguruj pozostałe ustawienia w aplikacji.

Po utworzeniu użyj REST API — Eksportuj dane historyczne lub pominięte, aby przesłać wybrany zakres lub sprawdzić konfigurację.

Powiązana dokumentacja