Automatizácia cez deep link

Vytvorte automatizáciu REST API otvorením URL na iPhone alebo iPade.

Posledná aktualizácia: 31. októbra 2026

Na tejto stránke

Formát URL

Referencia parametrov

Referencia parametrov Základné nastavenia Zdravotné metriky Tréningy Kadencia a oznámenia

Overenie a kódovanie

Príklady

Príklady Vybrané metriky, sumarizované po hodinách Tréningy s trasami

Riešenie problémov Súvisiaca dokumentácia

Vytvorte automatizáciu REST API otvorením URL na iPhone alebo iPade. Deep linky nenastavujú iné ciele.

Formát URL

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

url je povinné. Zadajte popisný name; ak sa vynechá, predvolene je Automation. Názvy parametrov nerozlišujú veľkosť písmen. Hodnoty parametrov s medzerami alebo rezervovanými znakmi kódujte URL kódovaním.

Otvorte URL na zariadení alebo v Skratkách použite Otvoriť URL. Pred zapnutím skontrolujte vytvorenú automatizáciu v Health Auto Export.

Referencia parametrov

Booleovské hodnoty prijímajú true/false, 1/0 alebo yes/no. Nastavte datatype pred jeho dátovo špecifickými možnosťami a format pred aggregatedata, aby neskoršie výbery nenahradili skoršie nastavenia.

Základné nastavenia

Parameter	Hodnoty alebo význam	Predvolené
`url`	URL koncového bodu dostupného zo zariadenia	Povinné
`name`	Neprázdny názov automatizácie	`Automation`
`enabled`	Povoliť automatické spustenia	`false`
`datatype`	Typ údajov uvedený nižšie	`healthMetrics`
`format`	`json`, `csv`, `markdown` alebo `md`	`json`
`exportversion`	`v1`, `v2`, `1` alebo `2`	`v2`
`period`	`none`, `lastsync`, `today`, `yesterday`, `previous7days`	`none`
`requesttimeout`	Celé sekundy, 60–86400	`60`
`headers`	Páry kľúč/hodnota oddelené čiarkami	Žiadne
`batchrequests`	Booleovské; len JSON	`false`

Platné typy údajov sú healthMetrics, workouts, symptoms, ecg, heartRateNotification, stateOfMind, cycleTracking a medications. Stav mysle vyžaduje iOS 18 alebo novší; exporty liekov vyžadujú iOS 26 alebo novší.

Významy rozsahu dátumov nájdete v Rozsah dátumov. Všetky deep linky vytvárajú automatizácie REST API; parameter exportDestination neexistuje.

Zdravotné metriky

Parameter	Hodnoty alebo význam	Predvolené
`metrics`	Presné názvy metrík oddelené čiarkami, napríklad `Step Count,Heart Rate`	Všetky dostupné metriky
`aggregatedata`	Booleovské; `false` pre jednotlivé hodnoty, kde je to podporované	`true`
`interval`	`none`, `minutes`, `hours`, `days`, `weeks`, `months`, `years`	`none`
`aggregatesleep`	Booleovské riadiace sumarizáciu spánku	`true`

metrics, aggregatedata a interval platia pre zdravotné metriky. Výber CSV zapína sumarizáciu; pre jednotlivé hodnoty použite JSON. Pri generovaní odkazov uveďte požadovanú sumarizáciu výslovne.

Tréningy

Parameter	Hodnoty alebo význam	Predvolené pri `datatype=workouts`
`includeroutes`	Booleovské	`true`
`includeworkoutmetadata`	Booleovské	`true`
`workoutsmetadatainterval`	`minutes` alebo `seconds`; Verzia 2	`minutes`
`workouttypes`	Identifikátory typov tréningov Apple (neznamienkové) oddelené čiarkami	Všetky typy

Do odkazu tréningu nezahŕňajte možnosti agregácie zdravotných metrík.

Kadencia a oznámenia

Parameter	Hodnoty alebo význam	Predvolené
`syncinterval`	`minutes`, `hours`, `days`, `weeks`	`minutes`
`syncquantity`	Kladné celé číslo intervalov	`5`
`notifyonupdate`	Booleovské; upozorniť po príprave údajov	`true`
`notifywhenrun`	Booleovské; upozorniť po úspešnej akcii v cieli	`true`

Kadencia ostáva podliehať limitom na pozadí a zdravotných údajov; nie je to presný rozvrh.

Overenie a kódovanie

Hodnota headers pozostáva z striedajúcich sa kľúčov a hodnôt:

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

Každý kľúč vyžaduje hodnotu. Čiarky oddeľujú páry, preto sa v tomto formáte odkazu vyhnite hodnotám hlavičiek obsahujúcim čiarky. Medzery kódujte ako %20, znamienka plus ako %2B a ampersandy ako %26. Keď má koncový bod vlastné parametre dopytu, zakódujte celú URL koncového bodu.

Príklady

Vybrané metriky, sumarizované po hodinách

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

Tréningy s 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 príklady nechávajú automatické spustenia vypnuté, kým automatizáciu neprehľadnete a nezapnete.

Riešenie problémov

Chyba URL alebo parametra: Začnite s minimálnou URL, skontrolujte pravopis a kódovanie a potom pridávajte možnosti jednotlivo.
Neplatná metrika: Použite presný názov metriky vrátane medzier a veľkosti písmen.
Chyba agregácie: Možnosti zdravotných metrík používajte len s datatype=healthMetrics.
Chyba nastavení tréningu: Možnosti tréningu používajte s datatype=workouts; zoskupenie po sekundách vyžaduje Verziu 2.
Chyba dávkovania: Nastavte format=json alebo vypnite batchrequests.
Neplatná kadencia/časový limit: Použite podporované intervaly, kladné množstvo a časový limit od 60 do 86400 sekúnd.
URL je príliš dlhá: Skráťte zoznam metrík/hlavičiek alebo zvyšné nastavenia dokončite v aplikácii.

Po vytvorení použite REST API — Export historických alebo vynechaných údajov na nahratie vybraného rozsahu alebo overenie nastavenia.