Deep Link -automaatio

Luo REST API -automaatio avaamalla URL iPhonessa tai iPadissa. Syvälinkit eivät määritä muita kohteita.

URL-muoto

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

url on pakollinen. Anna kuvaava name; jos se jätetään pois, oletusarvo on Automation. Parametrien nimet eivät erota kirjainkokoa. URL-koodaa parametriarvot, jotka sisältävät välilyöntejä tai varattuja merkkejä.

Avaa URL laitteella tai käytä Avaa URL:eja Pikakomennoissa. Ennen käyttöönottoa tarkista luotu automaatio Health Auto Exportissa.

Parametriviite

Boolean-arvot hyväksyvät true/false, 1/0 tai yes/no. Aseta datatype ennen sen tietokohtaisia vaihtoehtoja ja format ennen aggregatedata-parametria, jotta myöhemmät valinnat eivät korvaa aiempia asetuksia.

Perusasetukset

Parametri	Arvot tai merkitys	Oletus
url	Laitteelta saavutettava päätepisteen URL	Pakollinen
name	Automaation ei-tyhjä nimi	Automation
enabled	Salli automaattiset suoritukset	false
datatype	Alla lueteltu tietotyyppi	healthMetrics
format	json, csv, markdown tai md	json
exportversion	v1, v2, 1 tai 2	v2
period	none, lastsync, today, yesterday, previous7days	none
requesttimeout	Kokonaiset sekunnit, 60–86400	60
headers	Pilkuilla erotetut avain/arvo-parit	Ei mitään
batchrequests	Boolean; vain JSON	false

Kelvolliset tietotyypit ovat healthMetrics, workouts, symptoms, ecg, heartRateNotification, stateOfMind, cycleTracking ja medications. Mielen tila edellyttää iOS 18:aa tai uudempaa; lääkkeiden viennit edellyttävät iOS 26:ta tai uudempaa.

Päivämäärävälien merkityksistä katso Päivämääräväli. Kaikki syvälinkit luovat REST API -automaatioita; parametria exportDestination ei ole.

Terveysmittarit

Parametri	Arvot tai merkitys	Oletus
metrics	Tarkat mittarien nimet pilkuilla erotettuina, esimerkiksi Step Count,Heart Rate	Kaikki saatavilla olevat mittarit
aggregatedata	Boolean; käytä false yksittäisille lukemille, kun tuettu	true
interval	none, minutes, hours, days, weeks, months, years	none
aggregatesleep	Boolean, joka ohjaa unen tiivistystä	true

metrics, aggregatedata ja interval koskevat terveysmittareita. CSV-valinta ottaa tiivistyksen käyttöön; yksittäisiin lukemiin käytä JSON:ia. Generoidessasi linkkejä määritä haluttu tiivistys eksplisiittisesti.

Treenit

Parametri	Arvot tai merkitys	Oletus kun datatype=workouts
includeroutes	Boolean	true
includeworkoutmetadata	Boolean	true
workoutsmetadatainterval	minutes tai seconds; Versio 2	minutes
workouttypes	Applen treenityyppien tunnisteet pilkuilla erotettuina (unsigned)	Kaikki tyypit

Älä sisällytä terveysmittarien aggregointivaihtoehtoja treenilinkkiin.

Tahti ja ilmoitukset

Parametri	Arvot tai merkitys	Oletus
syncinterval	minutes, hours, days, weeks	minutes
syncquantity	Positiivinen kokonaisluku välejä	5
notifyonupdate	Boolean; ilmoitus tietojen valmistelun jälkeen	true
notifywhenrun	Boolean; ilmoitus onnistuneen kohdetoiminnon jälkeen	true

Tahti pysyy tausta- ja terveystietorajoitusten alaisena; se ei ole tarkka aikataulu.

Todennus ja koodaus

Arvo headers koostuu vuorottelevista avaimista ja arvoista:

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

Kullakin avaimella on oltava arvo. Pilkut erottavat parit, joten vältä tässä linkkimuodossa otsikkoarvoja, jotka sisältävät pilkkuja. Koodaa välilyönnit %20:ksi, plus-merkit %2B:ksi ja et-merkit %26:ksi. Koodaa koko päätepisteen URL, kun sillä on omia kyselyparametreja.

Esimerkkejä

Valitut mittarit, tiivistetty tuntikohtaisesti

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

Treenit reiteillä

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

Molemmat esimerkit jättävät automaattiset suoritukset pois käytöstä, kunnes tarkistat ja otat automaation käyttöön.

Vianmääritys

• URL- tai parametri virhe: Aloita minimoidulla URL:llä, tarkista kirjoitusasu ja koodaus, lisää sitten vaihtoehtoja yksi kerrallaan.
• Virheellinen mittari: Käytä tarkkaa mittarin nimeä välilyönteineen ja kirjainkokoineen.
• Aggregointivirhe: Käytä terveysmittarien vaihtoehtoja vain datatype=healthMetrics kanssa.
• Treeniasetusvirhe: Käytä treenivaihtoehtoja datatype=workouts kanssa; sekuntiryhmitys edellyttää Versiota 2.
• Erävirhe: Aseta format=json tai poista batchrequests käytöstä.
• Virheellinen tahti/aikakatkaisu: Käytä tuettuja välejä, positiivista määrää ja aikakatkaisua 60–86400 sekuntia.
• URL on liian pitkä: Pienennä mittari-/otsikkolistaa tai määritä loput asetukset sovelluksessa.

Luonnin jälkeen käytä REST API — Historiallisten tai väliin jääneiden tietojen vienti valitun välin lataamiseen tai asetusten tarkistamiseen.

Aiheeseen liittyvä dokumentaatio

• REST API -automaatio-opas
• Automaatioiden yleiskatsaus