Deep-linkautomatisering
Maak een REST API-automatisering door een URL op je iPhone of iPad te openen.
Laatst bijgewerkt: 31 oktober 2026
Op deze pagina
Maak een REST API-automatisering door een URL op je iPhone of iPad te openen. Deep links configureren geen andere bestemmingen.
URL-indeling
com.HealthExport://automation?url=https%3A%2F%2Fapi.example.com%2Fhealth&name=Daily%20Export
url is verplicht. Geef een beschrijvende name; indien weggelaten is de standaard Automation. Parameternamen zijn hoofdletterongevoelig. URL-codeer parameterwaarden met spaties of gereserveerde tekens.
Open de URL op je apparaat, of gebruik Open URLs in Opdrachten. Bekijk de gemaakte automatisering in Health Auto Export voordat je deze inschakelt.
Parameterreferentie
Booleans accepteren true/false, 1/0 of yes/no. Stel datatype in vóór de gegevenspecifieke opties, en format vóór aggregatedata, zodat latere selecties eerdere instellingen niet vervangen.
Basisinstellingen
| Parameter | Waarden of betekenis | Standaard |
|---|---|---|
url |
Eindpunt-URL bereikbaar vanaf je apparaat | Verplicht |
name |
Niet-lege automatiseringsnaam | Automation |
enabled |
Automatische uitvoeringen inschakelen | false |
datatype |
Gegevenstype hieronder | healthMetrics |
format |
json, csv, markdown of md |
json |
exportversion |
v1, v2, 1 of 2 |
v2 |
period |
none, lastsync, today, yesterday, previous7days |
none |
requesttimeout |
Gehele seconden, 60–86400 | 60 |
headers |
Kommagescheiden sleutel/waarde-paren | Geen |
batchrequests |
Boolean; alleen JSON | false |
Geldige gegevenstypen zijn healthMetrics, workouts, symptoms, ecg, heartRateNotification, stateOfMind, cycleTracking en medications. Gemoedstoestand vereist iOS 18 of nieuwer; medicijnenexporten vereisen iOS 26 of nieuwer.
Voor de betekenis van datumbereiken zie Datumbereik. Alle deep links maken REST API-automatiseringen; er is geen parameter exportDestination.
Gezondheidsmetrieken
| Parameter | Waarden of betekenis | Standaard |
|---|---|---|
metrics |
Kommagescheiden exacte metrieknamen, zoals Step Count,Heart Rate |
Alle beschikbare metrieken |
aggregatedata |
Boolean; gebruik false voor individuele metingen waar ondersteund |
true |
interval |
none, minutes, hours, days, weeks, months, years |
none |
aggregatesleep |
Boolean die slaapsamenvatting regelt | true |
metrics, aggregatedata en interval gelden voor gezondheidsmetrieken. CSV-selectie schakelt samenvatting in; gebruik JSON voor individuele metingen. Specificeer de gewenste samenvatting expliciet bij het genereren van links.
Trainingen
| Parameter | Waarden of betekenis | Standaard bij datatype=workouts |
|---|---|---|
includeroutes |
Boolean | true |
includeworkoutmetadata |
Boolean | true |
workoutsmetadatainterval |
minutes of seconds; Versie 2 |
minutes |
workouttypes |
Kommagescheiden unsigned Apple workout-type-identificaties | Alle typen |
Neem geen aggregatieopties voor gezondheidsmetrieken op in een trainingslink.
Cadans en meldingen
| Parameter | Waarden of betekenis | Standaard |
|---|---|---|
syncinterval |
minutes, hours, days, weeks |
minutes |
syncquantity |
Positief geheel aantal intervallen | 5 |
notifyonupdate |
Boolean; melden na gegevensvoorbereiding | true |
notifywhenrun |
Boolean; melden na een geslaagde bestemmingsactie | true |
Cadans blijft onderworpen aan achtergrond- en gezondheidsgegevenslimieten; het is geen exact schema.
Authenticatie en codering
De waarde headers bestaat uit afwisselende sleutels en waarden:
headers=Authorization,Bearer%20YOUR_TOKEN,X-API-Key,YOUR_KEY
Elke sleutel vereist een waarde. Komma’s scheiden paren, dus vermijd headerwaarden met komma’s in dit linkformaat. Codeer spaties als %20, plustekens als %2B en ampersands als %26. Codeer de volledige eindpunt-URL wanneer deze eigen queryparameters heeft.
Voorbeelden
Geselecteerde metrieken, samengevat per uur
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
Trainingen met routes
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
Beide voorbeelden laten automatische uitvoeringen uitgeschakeld tot je de automatisering bekijkt en inschakelt.
Problemen oplossen
- URL- of parameterfout: Begin met de minimale URL, controleer spelling en codering, en voeg opties één voor één toe.
- Ongeldige metriek: Gebruik de exacte metrieknaam, inclusief spaties en hoofdletters.
- Aggregatiefout: Gebruik opties voor gezondheidsmetrieken alleen met
datatype=healthMetrics. - Fout in trainingsinstellingen: Gebruik trainingsopties met
datatype=workouts; secondengroepering vereist Versie 2. - Batchfout: Stel
format=jsonin of schakelbatchrequestsuit. - Ongeldige cadans/timeout: Gebruik de ondersteunde intervallen, een positieve hoeveelheid en een timeout van 60 tot 86400 seconden.
- URL te lang: Verklein de metriek-/headerlijst of configureer de overige instellingen in de app.
Na het aanmaken gebruik je REST API — Historische of gemiste gegevens exporteren om een geselecteerd bereik te uploaden of je installatie te controleren.