Deep Link automatizálás

Hozzon létre REST API automatizálást URL megnyitásával iPhone-on vagy iPaden. A deep linkek nem konfigurálnak más célhelyeket.

URL-formátum

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

Az url kötelező. Adjon meg leíró name értéket; ha hiányzik, az alapértelmezés Automation. A paraméternemek nem érzékenyek a kis- és nagybetűkre. URL-kódolja a szóközt vagy foglalt karaktereket tartalmazó paraméterértékeket.

Nyissa meg az URL-t az eszközén, vagy használja az URL-ek megnyitása lehetőséget a Parancsokban. Tekintse át a létrehozott automatizálást a Health Auto Exportban, mielőtt engedélyezné.

Paraméter-hivatkozás

A logikai értékek elfogadják a true/false, 1/0 vagy yes/no értékeket. Állítsa be a datatype értéket az adatspecifikus opciók előtt, és a format értéket az aggregatedata előtt, hogy a későbbi választások ne cseréljék le a korábbi beállításokat.

Alapbeállítások

Paraméter	Értékek vagy jelentés	Alapértelmezés
url	Az eszközről elérhető végpont URL	Kötelező
name	Nemüres automatizálásnév	Automation
enabled	Automatikus futtatások engedélyezése	false
datatype	Az alábbi adattípus	healthMetrics
format	json, csv, markdown vagy md	json
exportversion	v1, v2, 1 vagy 2	v2
period	none, lastsync, today, yesterday, previous7days	none
requesttimeout	Egész másodpercek, 60–86400	60
headers	Vesszővel elválasztott kulcs/érték párok	Nincs
batchrequests	Logikai; csak JSON	false

Érvényes adattípusok: healthMetrics, workouts, symptoms, ecg, heartRateNotification, stateOfMind, cycleTracking és medications. A Lelkiállapothoz iOS 18 vagy újabb szükséges; a gyógyszerexportokhoz iOS 26 vagy újabb.

A dátumtartomány jelentéseiről lásd Dátumtartomány. Minden deep link REST API automatizálást hoz létre; nincs exportDestination paraméter.

Egészségügyi metrikák

Paraméter	Értékek vagy jelentés	Alapértelmezés
metrics	Vesszővel elválasztott pontos metrikanevek, például Step Count,Heart Rate	Minden elérhető metrika
aggregatedata	Logikai; használjon false értéket egyedi leolvasásokhoz, ahol támogatott	true
interval	none, minutes, hours, days, weeks, months, years	none
aggregatesleep	Logikai, amely az alvás összegzését szabályozza	true

A metrics, aggregatedata és interval egészségügyi metrikákra vonatkozik. A CSV-kiválasztás bekapcsolja az összegzést; egyedi leolvasásokhoz használjon JSON-t. Linkek generálásakor adja meg expliciten a kívánt összegzést.

Edzések

Paraméter	Értékek vagy jelentés	Alapértelmezés, ha datatype=workouts
includeroutes	Logikai	true
includeworkoutmetadata	Logikai	true
workoutsmetadatainterval	minutes vagy seconds; 2. verzió	minutes
workouttypes	Vesszővel elválasztott előjel nélküli Apple edzéstípus-azonosítók	Minden típus

Ne vegyen fel egészségügyi metrika összegzési opciókat edzéslinkbe.

Ütem és értesítések

Paraméter	Értékek vagy jelentés	Alapértelmezés
syncinterval	minutes, hours, days, weeks	minutes
syncquantity	Pozitív egész intervallumszám	5
notifyonupdate	Logikai; értesítés az adatok előkészítése után	true
notifywhenrun	Logikai; értesítés sikeres célhely-művelet után	true

Az ütem továbbra is a háttér- és egészségügyiadat-korlátozások alá esik; nem pontos menetrend.

Hitelesítés és kódolás

A headers érték váltakozó kulcsokból és értékekből áll:

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

Minden kulcshoz érték szükséges. A vesszők választják el a párokat, ezért kerülje a vesszőt tartalmazó fejlécértékeket ebben a linkformátumban. A szóközt %20-ként, a pluszjelet %2B-ként, az ésjelet %26-ként kódolja. Kódolja a teljes végpont-URL-t, ha saját lekérdezési paraméterei vannak.

Példák

Kiválasztott metrikák, óránként összegzve

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

Edzések útvonalakkal

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

Mindkét példa letiltva hagyja az automatikus futtatásokat, amíg át nem tekinti és engedélyezi az automatizálást.

Hibaelhárítás

• URL- vagy paraméterhiba: Kezdje a minimális URL-lel, ellenőrizze a helyesírást és a kódolást, majd adja hozzá az opciókat egyenként.
• Érvénytelen metrika: Használja a pontos metrikanevet, beleértve a szóközt és a kis-/nagybetűket.
• Összegzési hiba: Az egészségügyi metrika opciókat csak datatype=healthMetrics mellett használja.
• Edzésbeállítás-hiba: Az edzésopciókat datatype=workouts mellett használja; a másodperc-csoportosításhoz 2. verzió szükséges.
• Kötegelési hiba: Állítsa be a format=json értéket, vagy kapcsolja ki a batchrequests lehetőséget.
• Érvénytelen ütem/időtúllépés: Használja a támogatott intervallumokat, pozitív mennyiséget, és 60–86400 másodperces időtúllépést.
• Túl hosszú URL: Csökkentse a metrika-/fejléclistát, vagy állítsa be a fennmaradó beállításokat az alkalmazásban.

Létrehozás után használja a REST API — Előzmény- vagy kihagyott adatok exportálása lehetőséget kiválasztott tartomány feltöltéséhez vagy a beállítás ellenőrzéséhez.

Kapcsolódó dokumentáció

• REST API automatizálás útmutató
• Automatizálások áttekintése