Hjelpsenter HealthyApps
Norsk Bokmål
Hjelpsenter
Hovednettsted ↗

Søk i hjelpeemner

Deep Link-automatisering

Opprett en REST API-automatisering ved å åpne en URL på iPhone eller iPad.

Sist oppdatert: 31. oktober 2026

På denne siden
URL-format
Parameterreferanse Parameterreferanse Grunnleggende innstillingerHelsemålTreningsøkterKadens og varsler
Autentisering og koding
Eksempler Eksempler Valgte mål, summerte per timeTreningsøkter med ruter
FeilsøkingRelatert dokumentasjon

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

Relatert dokumentasjon