Deep Link-automatisering
Opprett en REST API-automatisering ved å åpne en URL på iPhone eller iPad.
Sist oppdatert: 31. oktober 2026
På denne siden
Opprett en REST API-automatisering ved å åpne en URL på iPhone eller iPad. Deep links konfigurerer ikke andre destinasjoner.
URL-format
com.HealthExport://automation?url=https%3A%2F%2Fapi.example.com%2Fhealth&name=Daily%20Export
url er obligatorisk. Angi et beskrivende name; hvis det utelates, er standardverdien Automation. Parameternavn skiller ikke mellom store og små bokstaver. URL-kod parameterverdier som inneholder mellomrom eller reserverte tegn.
Åpne URL-en på enheten, eller bruk Åpne URL-er i Snarveier. Gjennomgå den opprettede automatiseringen i Health Auto Export før du aktiverer den.
Parameterreferanse
Boolske verdier godtar true/false, 1/0 eller yes/no. Angi datatype før dens dataspesifikke innstillinger og format før aggregatedata, slik at senere valg ikke erstatter tidligere innstillinger.
Grunnleggende innstillinger
| Parameter | Verdier eller betydning | Standard |
|---|---|---|
url |
Endepunkt-URL som er tilgjengelig fra enheten | Obligatorisk |
name |
Ikke-tomt automatiseringsnavn | Automation |
enabled |
Aktiver automatiske kjøringer | false |
datatype |
Datatype listet nedenfor | healthMetrics |
format |
json, csv, markdown eller md |
json |
exportversion |
v1, v2, 1 eller 2 |
v2 |
period |
none, lastsync, today, yesterday, previous7days |
none |
requesttimeout |
Heltallssekunder, 60–86400 | 60 |
headers |
Kommaseparerte nøkkel/verdi-par | Ingen |
batchrequests |
Boolsk; bare JSON | false |
Gyldige datatyper er healthMetrics, workouts, symptoms, ecg, heartRateNotification, stateOfMind, cycleTracking og medications. Sinnstilstand krever iOS 18 eller nyere; medisineksporter krever iOS 26 eller nyere.
Se Datointervall for betydninger av datointervall. Alle deep links oppretter REST API-automatiseringer; det finnes ingen exportDestination-parameter.
Helsemål
| Parameter | Verdier eller betydning | Standard |
|---|---|---|
metrics |
Kommaseparerte eksakte målnavn, for eksempel Step Count,Heart Rate |
Alle tilgjengelige mål |
aggregatedata |
Boolsk; bruk false for enkeltmålinger der det støttes |
true |
interval |
none, minutes, hours, days, weeks, months, years |
none |
aggregatesleep |
Boolsk som styrer søvnsummering | true |
metrics, aggregatedata og interval gjelder for helsemål. CSV-valg slår på summering; bruk JSON for enkeltmålinger. Angi ønsket summering eksplisitt når du genererer lenker.
Treningsøkter
| Parameter | Verdier eller betydning | Standard når datatype=workouts |
|---|---|---|
includeroutes |
Boolsk | true |
includeworkoutmetadata |
Boolsk | true |
workoutsmetadatainterval |
minutes eller seconds; Versjon 2 |
minutes |
workouttypes |
Kommaseparerte usignerte Apple-treningstypeidentifikatorer | Alle typer |
Ikke inkluder aggregeringsinnstillinger for helsemål i en treningslenke.
Kadens og varsler
| Parameter | Verdier eller betydning | Standard |
|---|---|---|
syncinterval |
minutes, hours, days, weeks |
minutes |
syncquantity |
Positivt heltallsantall intervaller | 5 |
notifyonupdate |
Boolsk; varsle etter dataforberedelse | true |
notifywhenrun |
Boolsk; varsle etter en vellykket destinasjonshandling | true |
Kadensen er fortsatt underlagt bakgrunns- og helsedatagrense; det er ikke en nøyaktig tidsplan.
Autentisering og koding
Verdien headers består av vekslende nøkler og verdier:
headers=Authorization,Bearer%20YOUR_TOKEN,X-API-Key,YOUR_KEY
Hver nøkkel krever en verdi. Komma skiller par, så unngå hodeverdier som inneholder komma i dette lenkeformatet. Kod mellomrom som %20, plusstegn som %2B og et-tegn som %26. Kod den fullstendige endepunkt-URL-en når den har egne spørreparametere.
Eksempler
Valgte mål, summerte per time
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
Treningsøkter med ruter
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
Begge eksemplene lar automatiske kjøringer være deaktivert til du gjennomgår og aktiverer automatiseringen.
Feilsøking
- URL- eller parameterfeil: Start med den minimale URL-en, sjekk stavemåte og koding, og legg deretter til innstillinger én om gangen.
- Ugyldig mål: Bruk det eksakte målnavnet, inkludert mellomrom og store/små bokstaver.
- Aggregeringsfeil: Bruk innstillinger for helsemål bare med
datatype=healthMetrics. - Feil i treningsinnstillinger: Bruk treningsinnstillinger med
datatype=workouts; sekundgruppering krever Versjon 2. - Batchfeil: Angi
format=json, eller deaktiverbatchrequests. - Ugyldig kadens/timeout: Bruk de støttede intervallene, en positiv mengde og en timeout fra 60 til 86400 sekunder.
- URL for lang: Reduser listen over mål/hoder, eller konfigurer øvrige innstillinger i appen.
Etter oppretting bruker du REST API — Eksportere historiske eller manglende data for å laste opp et valgt intervall eller sjekke konfigurasjonen.