Automatyzacja Deep Link
Utwórz automatyzację REST API, otwierając URL na iPhonie lub iPadzie.
Ostatnia aktualizacja: 31 października 2026
Na tej stronie
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=jsonalbo wyłączbatchrequests. - 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ę.