Automatizacija Deep Link

Stvorite automatizaciju REST API otvaranjem URL-a na iPhoneu ili iPadu. Deep linkovi ne konfiguriraju druga odredišta.

Format URL-a

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

url je obavezan. Navedite opisni name; ako je izostavljen, zadana vrijednost je Automation. Nazivi parametara ne razlikuju veličinu slova. Vrijednosti parametara koje sadrže razmake ili rezervirane znakove URL-kodirajte.

Otvorite URL na uređaju ili koristite Otvori URL-ove u Prečacima. Prije omogućavanja pregledajte stvorenu automatizaciju u Health Auto Exportu.

Referenca parametara

Booleove vrijednosti prihvaćaju true/false, 1/0 ili yes/no. Postavite datatype prije njegovih opcija specifičnih za podatke i format prije aggregatedata, kako kasniji odabiri ne bi zamijenili ranije postavke.

Osnovne postavke

Parametar	Vrijednosti ili značenje	Zadano
url	URL krajnje točke dostupan s uređaja	Obavezno
name	Neprazan naziv automatizacije	Automation
enabled	Omogući automatska pokretanja	false
datatype	Tip podataka naveden dolje	healthMetrics
format	json, csv, markdown ili md	json
exportversion	v1, v2, 1 ili 2	v2
period	none, lastsync, today, yesterday, previous7days	none
requesttimeout	Cijele sekunde, 60–86400	60
headers	Parovi ključ/vrijednost odvojeni zarezima	Nema
batchrequests	Boolean; samo JSON	false

Važeći tipovi podataka su healthMetrics, workouts, symptoms, ecg, heartRateNotification, stateOfMind, cycleTracking i medications. Stanje uma zahtijeva iOS 18 ili noviji; izvozi lijekova zahtijevaju iOS 26 ili noviji.

Značenja raspona datuma pogledajte u Rasponu datuma. Svi deep linkovi stvaraju automatizacije REST API; parametar exportDestination ne postoji.

Zdravstvene metrike

Parametar	Vrijednosti ili značenje	Zadano
metrics	Točni nazivi metrika odvojeni zarezima, na primjer Step Count,Heart Rate	Sve dostupne metrike
aggregatedata	Boolean; koristite false za pojedinačna očitanja gdje su podržana	true
interval	none, minutes, hours, days, weeks, months, years	none
aggregatesleep	Boolean koji kontrolira sažimanje sna	true

metrics, aggregatedata i interval vrijede za zdravstvene metrike. Odabir CSV uključuje sažimanje; za pojedinačna očitanja koristite JSON. Pri generiranju poveznica eksplicitno navedite željeno sažimanje.

Treninzi

Parametar	Vrijednosti ili značenje	Zadano pri datatype=workouts
includeroutes	Boolean	true
includeworkoutmetadata	Boolean	true
workoutsmetadatainterval	minutes ili seconds; Verzija 2	minutes
workouttypes	Identifikatori tipova treninga Apple odvojeni zarezima (unsigned)	Svi tipovi

U poveznicu treninga ne uključujte opcije agregacije zdravstvenih metrika.

Ritam i obavijesti

Parametar	Vrijednosti ili značenje	Zadano
syncinterval	minutes, hours, days, weeks	minutes
syncquantity	Pozitivan cijeli broj intervala	5
notifyonupdate	Boolean; obavijesti nakon pripreme podataka	true
notifywhenrun	Boolean; obavijesti nakon uspješne radnje odredišta	true

Ritam ostaje podložan ograničenjima u pozadini i zdravstvenih podataka; nije točan raspored.

Autentifikacija i kodiranje

Vrijednost headers sastoji se od naizmjeničnih ključeva i vrijednosti:

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

Svaki ključ zahtijeva vrijednost. Zarezi odvajaju parove, pa u ovom formatu poveznice izbjegavajte vrijednosti zaglavlja koje sadrže zareze. Razmake kodirajte kao %20, plusove kao %2B, a ampersande kao %26. Kodirajte potpuni URL krajnje točke kada ima vlastite query parametre.

Primjeri

Odabrane metrike, sažete satno

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

Treninzi s rutama

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 primjera ostavljaju automatska pokretanja onemogućena dok ne pregledate i omogućite automatizaciju.

Rješavanje problema

• Pogreška URL-a ili parametra: Počnite s minimalnim URL-om, provjerite pravopis i kodiranje, zatim dodajte opcije pojedinačno.
• Nevažeća metrika: Koristite točan naziv metrike uključujući razmake i veličinu slova.
• Pogreška agregacije: Opcije zdravstvenih metrika koristite samo s datatype=healthMetrics.
• Pogreška postavki treninga: Opcije treninga koristite s datatype=workouts; sekundna grupacija zahtijeva Verziju 2.
• Pogreška grupiranja: Postavite format=json ili onemogućite batchrequests.
• Nevažeći ritam/vremensko ograničenje: Koristite podržane intervale, pozitivnu količinu i vremensko ograničenje od 60 do 86400 sekundi.
• URL je predug: Smanjite popis metrika/zaglavlja ili preostale postavke konfigurirajte u aplikaciji.

Nakon stvaranja koristite REST API — Izvoz povijesnih ili propuštenih podataka za učitavanje odabranog raspona ili provjeru postavki.

Povezana dokumentacija

• Vodič za automatizaciju REST API
• Pregled automatizacija