Helpcentrum HealthyApps
Nederlands
Helpcentrum
Hoofdwebsite ↗

Zoek in helponderwerpen

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
URL-indeling
Parameterreferentie Parameterreferentie BasisinstellingenGezondheidsmetriekenTrainingenCadans en meldingen
Authenticatie en codering
Voorbeelden Voorbeelden Geselecteerde metrieken, samengevat per uurTrainingen met routes
Problemen oplossenGerelateerde documentatie

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=json in of schakel batchrequests uit.
  • 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.

Gerelateerde documentatie