Deep Link-automatisering
Opret en REST API-automatisering ved at åbne en URL på din iPhone eller iPad.
Senest opdateret: 31. oktober 2026
På denne side
Opret en REST API-automatisering ved at åbne en URL på din iPhone eller iPad. Deep links konfigurerer ikke andre destinationer.
URL-format
com.HealthExport://automation?url=https%3A%2F%2Fapi.example.com%2Fhealth&name=Daily%20Export
url er påkrævet. Angiv et beskrivende name; hvis det udelades, er standardværdien Automation. Parameternavne skelner ikke mellem store og små bogstaver. URL-kod parameterværdier, der indeholder mellemrum eller reserverede tegn.
Åbn URL'en på din enhed, eller brug Åbn URL'er i Genveje. Gennemgå den oprettede automatisering i Health Auto Export, før du aktiverer den.
Parameterreference
Booleanske værdier accepterer true/false, 1/0 eller yes/no. Angiv datatype før dens dataspecifikke indstillinger og format før aggregatedata, så senere valg ikke erstatter tidligere indstillinger.
Grundlæggende indstillinger
| Parameter | Værdier eller betydning | Standard |
|---|---|---|
url |
Slutpunkts-URL, der er tilgængelig fra din enhed | Påkrævet |
name |
Ikke-tomt automatiseringsnavn | Automation |
enabled |
Aktiver automatiske kørsler | 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 |
Heltalssekunder, 60–86400 | 60 |
headers |
Kommaseparerede nøgle/værdipar | Ingen |
batchrequests |
Boolesk; kun JSON | false |
Gyldige datatyper er healthMetrics, workouts, symptoms, ecg, heartRateNotification, stateOfMind, cycleTracking og medications. Sindstilstand kræver iOS 18 eller nyere; medicineksporter kræver iOS 26 eller nyere.
Se Datointerval for betydninger af datointervaller. Alle deep links opretter REST API-automatiseringer; der er ingen exportDestination-parameter.
Sundhedsmålinger
| Parameter | Værdier eller betydning | Standard |
|---|---|---|
metrics |
Kommaseparerede nøjagtige målingsnavne, såsom Step Count,Heart Rate |
Alle tilgængelige målinger |
aggregatedata |
Boolesk; brug false til individuelle målinger, hvor det understøttes |
true |
interval |
none, minutes, hours, days, weeks, months, years |
none |
aggregatesleep |
Boolesk, der styrer søvnopsummering | true |
metrics, aggregatedata og interval gælder for sundhedsmålinger. CSV-valg slår opsummering til; brug JSON til individuelle målinger. Angiv den ønskede opsummering eksplicit, når du genererer links.
Træninger
| Parameter | Værdier eller betydning | Standard når datatype=workouts |
|---|---|---|
includeroutes |
Boolesk | true |
includeworkoutmetadata |
Boolesk | true |
workoutsmetadatainterval |
minutes eller seconds; Version 2 |
minutes |
workouttypes |
Kommaseparerede usignerede Apple-træningstypeidentifikatorer | Alle typer |
Inkluder ikke aggregeringsindstillinger for sundhedsmålinger i et træningslink.
Kadens og notifikationer
| Parameter | Værdier eller betydning | Standard |
|---|---|---|
syncinterval |
minutes, hours, days, weeks |
minutes |
syncquantity |
Positivt heltalsantal af intervaller | 5 |
notifyonupdate |
Boolesk; giv besked efter dataforberedelse | true |
notifywhenrun |
Boolesk; giv besked efter en vellykket destinationshandling | true |
Kadens er stadig underlagt baggrunds- og sundhedsdatagrænser; det er ikke en nøjagtig tidsplan.
Godkendelse og kodning
Værdien headers består af skiftende nøgler og værdier:
headers=Authorization,Bearer%20YOUR_TOKEN,X-API-Key,YOUR_KEY
Hver nøgle kræver en værdi. Kommaer adskiller par, så undgå headerværdier, der indeholder kommaer, i dette linkformat. Kod mellemrum som %20, plustegn som %2B og ampersands som %26. Kod den fulde slutpunkts-URL, når den har sine egne forespørgselsparametre.
Eksempler
Valgte målinger, opsummeret pr. 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
Træninger 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 eksempler lader automatiske kørsler være deaktiveret, indtil du gennemgår og aktiverer automatiseringen.
Fejlfinding
- URL- eller parameterfejl: Start med den minimale URL, tjek stavning og kodning, og tilføj derefter indstillinger enkeltvis.
- Ugyldig måling: Brug det nøjagtige målingsnavn, inklusive mellemrum og store/små bogstaver.
- Aggregeringsfejl: Brug indstillinger for sundhedsmålinger kun med
datatype=healthMetrics. - Fejl i træningsindstillinger: Brug træningsindstillinger med
datatype=workouts; sekundgruppering kræver Version 2. - Batching-fejl: Angiv
format=json, eller deaktiverbatchrequests. - Ugyldig kadens/timeout: Brug de understøttede intervaller, en positiv mængde og en timeout fra 60 til 86400 sekunder.
- URL for lang: Reducer listen over målinger/headere, eller konfigurer de resterende indstillinger i appen.
Efter oprettelse skal du bruge REST API — Eksporter historiske eller manglende data til at uploade et valgt interval eller tjekke din opsætning.