Hjælpecenter HealthyApps
Dansk
Hjælpecenter
Hovedwebsted ↗

Søg i hjælpeemner

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
URL-format
Parameterreference Parameterreference Grundlæggende indstillingerSundhedsmålingerTræningerKadens og notifikationer
Godkendelse og kodning
Eksempler Eksempler Valgte målinger, opsummeret pr. timeTræninger med ruter
FejlfindingRelateret dokumentation

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 deaktiver batchrequests.
  • 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.

Relateret dokumentation