HealthyApps Help Center

Automatizácia deep link

Vytvárajte automatizácie programovo pomocou URL schém.

Last updated: April 6, 2026

Na tejto stránke

Automatizácie deep link umožňujú programovo vytvárať automatizácie REST API pomocou URL schém. Hodí sa na skripty automatizácií, správu konfigurácie alebo integráciu s externými systémami, ktoré potrebujú nastaviť export zdravotných údajov.

Prehľad

Automatizácie deep link používajú vlastnú URL schému na vytvorenie a konfiguráciu automatizácií REST API bez ručného zadávania nastavení v aplikácii. Po otvorení URL deep link aplikácia automaticky vytvorí novú automatizáciu so zadanou konfiguráciou.

Prípady použitia:

  • Programové nastavenie automatizácií zo skriptov alebo nástrojov
  • Hromadná konfigurácia automatizácií
  • Integrácia so systémami správy konfigurácie
  • Rýchle nastavenie z externých aplikácií alebo webov
  • Testovanie a vývojové postupy

Hlavné funkcie:

  • Vytváranie automatizácií cez URL schému
  • Konfigurácia všetkých nastavení automatizácie REST API
  • Typovo bezpečná validácia parametrov
  • Podrobné chybové hlásenia

Obmedzenia

  • Deep link podporuje len automatizácie REST API (nie Dropbox, Google Drive atď.)
  • Dĺžka URL môže obmedziť veľmi dlhé zoznamy parametrov
  • Platia aj obmedzenia automatizácií REST API (spracovanie na pozadí, prístup k zdravotným údajom atď.)

Formát URL

Deep link URL má tvar:

com.HealthExport://automation?parameter1=value1&parameter2=value2&...

Základná URL: com.HealthExport://automation

Parametre: Všetky parametre sú voliteľné okrem name a url. Názvy parametrov nie sú citlivé na veľkosť písmen.

Referencia parametrov

Povinné parametre

url (povinné)

  • Typ: Reťazec (platná URL)
  • Popis: Koncový bod (URL), na ktorý sa budú posielať zdravotné údaje
  • Príklad: https://api.example.com/health-data
  • Poznámka: Musí to byť platná HTTP/HTTPS URL

name (povinné)

  • Typ: Reťazec
  • Popis: Výstižný názov automatizácie
  • Príklad: My%20Backend%20API (URL-kódované: My Backend API)
  • Poznámka: Pri medzerách alebo špeciálnych znakoch treba URL-kódovanie

Základná konfigurácia

format

  • Typ: Enum (json, csv)
  • Predvolené: json
  • Popis: Formát exportu údajov
  • Príklad: format=json alebo format=csv
  • Poznámka: Formát CSV automaticky zapína agregáciu údajov

enabled

  • Typ: Boolean (true, false, 1, 0, yes, no)
  • Predvolené: false
  • Popis: Či má byť automatizácia hneď po vytvorení zapnutá
  • Príklad: enabled=true

datatype

  • Typ: Enum (pozri typy údajov nižšie)
  • Predvolené: healthMetrics
  • Popis: Typ exportovaných zdravotných údajov
  • Príklad: datatype=workouts
  • Poznámka: Vyberá sa len jeden typ; nastavenie automaticky nakonfiguruje príslušné príznaky zahrnutia.

Platné typy údajov:

  • healthMetrics — zdravotné metriky (kroky, srdcová frekvencia, spánok atď.)
  • workouts — cvičenia a športové aktivity
  • symptoms — príznaky a zdravotné stavy
  • ecg — záznamy EKG
  • heartRateNotification — udalosti vysokej/nízkej srdcovej frekvencie
  • stateOfMind — záznamy nálady a duševného stavu (iOS 18.0+)
  • cycleTracking — menštruačný cyklus a reprodukčné zdravotné údaje
  • medications — záznamy liekov a adherencia (iOS 26.0+)

Nastavenia exportu

period

  • Typ: Enum
  • Predvolené: none
  • Popis: Časové rozpätie exportu údajov
  • Príklad: period=today

Platné hodnoty:

  • none — predvolené (celý predchádzajúci deň plus aktuálny deň)
  • lastsync — od poslednej synchronizácie
  • today — aktuálny deň
  • yesterday — predchádzajúci deň
  • previous7days — predchádzajúcich 7 dní
  • realtime — aktualizácie v reálnom čase (vyžaduje interval synchronizácie v sekundách)

interval

  • Typ: Enum
  • Predvolené: none
  • Popis: Časové zoskupenie / interval agregácie (platné len pre typ údajov healthMetrics)
  • Príklad: interval=hours

Platné hodnoty:

  • none — predvolené (bez agregácie)
  • minutes — zoskupenie po minútach
  • hours — zoskupenie po hodinách
  • days — zoskupenie po dňoch
  • weeks — zoskupenie po týždňoch
  • months — zoskupenie po mesiacoch
  • years — zoskupenie po rokoch

Poznámka: Tento parameter platí len pri datatype=healthMetrics. Formát CSV vždy agreguje údaje.

aggregatedata

  • Typ: Boolean
  • Predvolené: true (CSV), false (JSON)
  • Popis: Či agregovať / zhrnúť údaje (platné len pre healthMetrics s formátom JSON)
  • Príklad: aggregatedata=true
  • Poznámka: Pri format=csv sa automaticky nastaví na true

aggregatesleep

  • Typ: Boolean
  • Predvolené: true
  • Popis: Či agregovať údaje o spánku
  • Príklad: aggregatesleep=true

exportversion

  • Typ: Enum (v1, v2, 1, 2)
  • Predvolené: v2
  • Popis: Verzia formátu exportu
  • Príklad: exportversion=v2
  • Poznámka: Verzia 2 obsahuje rozšírené údaje o tréningoch a podrobnejšie metadáta

batchrequests

  • Typ: Boolean
  • Predvolené: false
  • Popis: Posielať údaje po dávkach vo viacerých požiadavkách (platné len pre REST API s formátom JSON)
  • Príklad: batchrequests=true
  • Poznámka: Platí len pri format=json a exportDestination=restApi

Frekvencia synchronizácie

syncinterval

  • Typ: Enum
  • Predvolené: minutes
  • Popis: Interval frekvencie synchronizácie
  • Príklad: syncinterval=hours

Platné hodnoty:

  • minutes — synchronizácia každých N minút
  • hours — synchronizácia každých N hodín
  • days — synchronizácia každých N dní
  • weeks — synchronizácia každých N týždňov
  • seconds — len pri period=realtime

Poznámka: Pre automatizácie REST API sú platné len minutes, hours, days a weeks, ak nepoužívate export v reálnom čase.

syncquantity

  • Typ: Celé číslo (kladné)
  • Predvolené: 5
  • Popis: Počet intervalov medzi synchronizáciami
  • Príklad: syncquantity=10 (synchronizácia každých 10 minút pri syncinterval=minutes)
  • Poznámka: Musí byť väčšie ako 0

Konfigurácia HTTP

headers

  • Typ: Reťazec (páry kľúč–hodnota oddelené čiarkami)
  • Predvolené: Žiadne
  • Popis: HTTP hlavičky na autentifikáciu alebo metadáta
  • Príklad: headers=Authorization,Bearer%20token123,X-API-Key,abc123
  • Formát: key1,value1,key2,value2,...
  • Poznámka: Hodnoty treba URL-kódovať. Každá hlavička vyžaduje kľúč aj hodnotu.

Príklady hlavičiek:

  • Authorization, Bearer your-token
  • X-API-Key, your-api-key
  • Content-Type, application/json

requesttimeout

  • Typ: Celé číslo (60–86400)
  • Predvolené: 60
  • Popis: Časový limit požiadavky v sekundách
  • Príklad: requesttimeout=300
  • Poznámka: Musí byť v rozsahu 60 až 86400 sekúnd (1 minúta až 24 hodín)

Nastavenia podľa typu údajov

Nastavenia zdravotných metrík

metrics
  • Typ: Reťazec (MetricName rawValues oddelené čiarkami)
  • Predvolené: Všetky dostupné metriky
  • Popis: Konkrétne zdravotné metriky na zahrnutie (platné len pre typ údajov healthMetrics)
  • Príklad: metrics=Step%20Count,Heart%20Rate,Active%20Energy
  • Poznámka: Musia sa použiť presné MetricName rawValues. Ak nie sú zadané, zahrnú sa všetky dostupné metriky.

Bežné názvy metrík:

  • Step Count
  • Heart Rate
  • Active Energy
  • Apple Exercise Time
  • Sleep Analysis
  • Walking + Running Distance

Úplný zoznam dostupných metrík nájdete na obrazovke výberu metrík v aplikácii.

Nastavenia tréningov

includeroutes
  • Typ: Boolean
  • Predvolené: true
  • Popis: Zahrnúť údaje o trase (platné len pre typ údajov workouts)
  • Príklad: includeroutes=true
includeworkoutmetadata
  • Typ: Boolean
  • Predvolené: true
  • Popis: Zahrnúť metriky tréningu (srdcová frekvencia, kalórie atď.) zozbierané počas tréningu (platné len pre typ údajov workouts)
  • Príklad: includeworkoutmetadata=true
workoutsmetadatainterval
  • Typ: Enum (minutes, seconds)
  • Predvolené: minutes
  • Popis: Časové zoskupenie metrík tréningu (platné len pre typ údajov workouts s exportVersion v2)
  • Príklad: workoutsmetadatainterval=seconds
  • Poznámka: Platí len pri datatype=workouts a exportversion=v2
workouttypes
  • Typ: Reťazec (hodnoty UInt oddelené čiarkami)
  • Predvolené: Prázdne (všetky typy tréningov)
  • Popis: Konkrétne typy tréningov na zahrnutie (platné len pre typ údajov workouts)
  • Príklad: workouttypes=1,2,3
  • Poznámka: Používajú sa identifikátory typov tréningov HealthKit

Upozornenia

notifyonupdate

  • Typ: Boolean
  • Predvolené: true
  • Popis: Upozornenia pri aktualizácii dát vo vyrovnávacej pamäti
  • Príklad: notifyonupdate=true

notifywhenrun

  • Typ: Boolean
  • Predvolené: true
  • Popis: Upozornenia pri každom spustení automatizácie
  • Príklad: notifywhenrun=false

Príklady

Základná automatizácia REST API

com.HealthExport://automation?url=https://api.example.com/health&name=My%20Automation&format=json&enabled=true

Vytvorí základnú automatizáciu, ktorá posiela údaje vo formáte JSON na zadaný koncový bod.

S autentifikačnými hlavičkami

com.HealthExport://automation?url=https://api.example.com/health&name=Authenticated%20API&format=json&headers=Authorization,Bearer%20your-token-here,X-API-Key,abc123&enabled=true

Vytvorí automatizáciu s vlastnými autentifikačnými hlavičkami.

Zdravotné metriky s konkrétnymi metrikami

com.HealthExport://automation?url=https://api.example.com/metrics&name=Steps%20and%20Heart%20Rate&format=json&datatype=healthMetrics&metrics=Step%20Count,Heart%20Rate&aggregatedata=true&interval=hours&enabled=true

Vytvorí automatizáciu, ktorá exportuje len kroky a srdcovú frekvenciu, agregované po hodinách.

Tréningy s údajmi o trase

com.HealthExport://automation?url=https://api.example.com/workouts&name=Workout%20Export&format=json&datatype=workouts&includeroutes=true&includeworkoutmetadata=true&exportversion=v2&workoutsmetadatainterval=minutes&enabled=true

Vytvorí automatizáciu pre tréningy s údajmi o trase a metrikami tréningu s exportnou verziou 2.

Príklad úplnej konfigurácie

com.HealthExport://automation?url=https://api.example.com/health-data&name=Complete%20Configuration&format=json&datatype=healthMetrics&period=today&interval=hours&aggregatedata=true&aggregatesleep=true&exportversion=v2&syncinterval=hours&syncquantity=2&headers=Authorization,Bearer%20token123&requesttimeout=300&batchrequests=true&notifyonupdate=true&notifywhenrun=false&enabled=true

Rozsiahly príklad so všetkými hlavnými parametrami nakonfigurovanými.

Príklad formátu CSV

com.HealthExport://automation?url=https://api.example.com/csv&name=CSV%20Export&format=csv&datatype=healthMetrics&period=yesterday&enabled=true

Vytvorí automatizáciu exportu CSV. Formát CSV automaticky zapína agregáciu údajov.

URL kódovanie

Špeciálne znaky v hodnotách parametrov treba kódovať do URL. Bežné náhrady:

  • Medzera: %20
  • Čiarka: %2C
  • Dvojbodka: %3A
  • Bodkočiarka: %3B
  • Rovná sa: %3D
  • Ampersand: %26
  • Plus: %2B

Príklad:

  • Pôvod: My Automation Name
  • Zakódované: My%20Automation%20Name

Príklad hlavičiek:

  • Pôvod: Authorization, Bearer token123
  • Zakódované: Authorization,Bearer%20token123

Väčšina programovacích jazykov a nástrojov ponúka funkcie na URL kódovanie:

  • Swift: addingPercentEncoding(withAllowedCharacters:)
  • JavaScript: encodeURIComponent()
  • Python: urllib.parse.quote()

Testovanie deep linkov

Zo Safari (iOS)

  1. Otvorte Safari na zariadení s iOS
  2. Zadajte URL deep link do adresného riadku
  3. Klepnite na Prejsť
  4. Aplikácia by sa mala otvoriť a vytvoriť automatizáciu

Riešenie problémov

Bežné problémy

„Could not parse the URL“

  • Skontrolujte schému URL: com.HealthExport://automation
  • Overte, že všetky hodnoty parametrov sú správne URL-kódované
  • Skontrolujte pravopis názvov parametrov (veľkosť písmen nezáleží)

„Invalid URL parameter value“

  • Overte, že URL je platná HTTP/HTTPS URL
  • Skontrolujte správne URL kódovanie
  • Uistite sa, že URL neobsahuje neplatné znaky

„Invalid data type“

  • Použite presné hodnoty typov údajov: healthMetrics, workouts, symptoms, ecg, heartRateNotification, stateOfMind, cycleTracking, medications
  • Skontrolujte pravopis a veľkosť písmen (podporované je aj porovnanie bez ohľadu na veľkosť)

„Invalid sync cadence interval“

  • Pre REST API používajte len: minutes, hours, days, weeks
  • seconds len pri period=realtime

„Aggregation settings are only valid for healthMetrics data type“

  • Parametre aggregatedata a interval fungujú len s datatype=healthMetrics
  • Odstráňte tieto parametre alebo zmeňte typ údajov

„Batch requests are only valid for REST API with JSON format“

  • batchrequests funguje len pri format=json
  • Zmeňte formát na JSON alebo parameter odstráňte

„Workout settings are only valid for workouts data type“

  • includeroutes, includeworkoutmetadata a workoutsmetadatainterval fungujú len s datatype=workouts
  • Zmeňte typ údajov na workouts alebo tieto parametre odstráňte

„Metrics parameter is only valid for healthMetrics data type“

  • Parameter metrics funguje len s datatype=healthMetrics
  • Zmeňte typ údajov alebo parameter odstráňte

„Invalid metric name“

  • Použite presné MetricName rawValues (napr. „Step Count“, „Heart Rate“)
  • Skontrolujte pravopis a veľkosť písmen
  • Platné názvy nájdete na obrazovke výberu metrík v aplikácii

„Invalid request timeout“

  • Musí byť v rozsahu 60 až 86400 sekúnd
  • Použite hodnotu v tomto rozsahu

„A name is required for the automation“

  • Uistite sa, že je zahrnutý parameter name
  • Overte, že hodnota po dekódovaní URL nie je prázdna

Obmedzenia dĺžky URL

Veľmi dlhé URL (najmä s mnohými metrikami alebo hlavičkami) môžu prekročiť systémové limity. Zvážte:

  • Použiť menej metrík v parametri metrics
  • Znížiť počet hlavičiek
  • Kde sa dá, použiť kratšie hodnoty parametrov
  • Rozdeliť zložité konfigurácie do viacerých jednoduchších automatizácií

Prednosť parametrov

Pri konfliktoch viacerých parametrov:

  1. Výber typu údajov (datatype) automaticky resetuje príznaky zahrnutia
  2. Formát CSV (format=csv) automaticky nastaví aggregatedata=true
  3. Režim v reálnom čase (period=realtime) vyžaduje syncinterval=seconds
  4. Pri nekompatibilných kombináciách sa vyvolajú chyby validácie

Osvedčené postupy

  1. Automatická synchronizácia (keď sa automatizácie spúšťajú cez deep link):

    • Nabíjajte zariadenie a používajte zrkadlenie iPhonu
      • Pri nabíjaní iOS menej obmedzuje výkon zariadenia, takže sa údaje môžu synchronizovať častejšie
      • Pri zrkadlení iPhonu sa zariadenie správa rovnako ako pri odomknutí. Zdravotné údaje sú tak pre Health Auto Export dostupné na spúšťanie automatizovaných akcií

  2. Vždy URL-kódujte hodnoty parametrov so špeciálnymi znakmi

  3. Najprv testujte s jednoduchými URL, potom pridávajte zložitosť

  4. Používajte výstižné názvy pre ľahšiu identifikáciu

  5. Overte URL pred programovým vytváraním deep linkov

  6. Spracujte chyby primerane pri parsovaní deep linkov

  7. Zdokumentujte formáty deep linkov, ak vytvárate nástroje, ktoré ich generujú

  8. Myslite na dĺžku URL pri zahrnutí mnohých metrík alebo hlavičiek

  9. Testujte na skutočných zariadeniach aj v simulátore

Súvisiaca dokumentácia

Podpora

Ak narazíte na problémy, ktoré tento sprievodca nepokrýva:

  1. Skontrolujte text chyby kvôli konkrétnym problémom s parametrami
  2. Overte správnosť URL kódovania
  3. Najprv otestujte s minimálnou URL
  4. V aplikácii použite tlačidlo Chat Support na pomoc