Synkroniser Apple Helse-data til REST API
Send helsedata til et REST API-endepunkt.
Sist oppdatert: 31. oktober 2026
På denne siden
Eksportinnstillinger
Eksportinnstillinger EksportformatEksportversjonDatointervallSummer data og tidsgrupperingSend helseeksporter til et endepunkt som godtar HTTP POST-forespørsler.
Viktig — begrensninger for automatiseringer: Enheten må være ulåst for å lese helsedata, og iOS garanterer ikke bakgrunnskjøringer med frekvensen du velger. Gjennomgå begrensninger for automatiseringer før du stoler på automatiske eksporter.
Åpne automatiseringen
Åpne Eksporter → Automatisert på iPhone, eller Automatiseringer i iPad-sidefeltet. Velg Ny automatisering, eller åpne en eksisterende for å redigere den.
Navn, status og varsler
Angi et navn som identifiserer automatiseringen. Aktivert tillater automatiske kjøringer; la den være av til du er klar.
Velg kjørevarslene du vil ha:
- Varsle ved hurtigbufferoppdatering rapporterer at eksportdata ble forberedt.
- Varsle ved kjøring rapporterer en vellykket opplasting til endepunktet ditt.
Tillat varsler når du blir bedt om det. Disse varslene rapporterer aktivitet; de planlegger ikke en kjøring.
Konfigurer endepunktet
- Velg REST API som Automatiseringstype.
- Angi en URL som er tilgjengelig fra iPhone eller iPad, for eksempel
https://api.example.com/health-data. - Legg til eventuell obligatorisk autentisering under HTTP-hoder. Bruk for eksempel
Authorizationsom nøkkel ogBearer YOUR_TOKENsom verdi. - Velg en Forespørselstimeout som passer endepunktet ditt.
Hvert hode må ha både en nøkkel og en verdi. For en server på en annen enhet bruker du dens tilgjengelige nettverksadresse i stedet for localhost.
Innstillinger for datatype
Velg en Datatype for denne automatiseringen: Helsemål, Treningsøkter, Symptomer, ECG, Hjertefrekvensvarsler, Sinnstilstand, Syklussporing eller Medisiner. Sinnstilstand krever iOS 18 eller nyere; Medisiner krever iOS 26 eller nyere og separat medisintilgang.
Helsemål
Velg Helsemål, åpne deretter Velg helsemål og velg målene du trenger.
For å begrense målinger til bestemte apper eller enheter åpner du Foretrukne kilder, velger et mål og velger kildene. Alle tillater hver kilde som ikke er ekskludert. Bruk Ekskluderte kilder for å ignorere en kilde over denne automatiseringens helsemål. Ekskluderinger har forrang; en ikke-valgt kilde erstattes ikke når en foretrukket kilde mangler data. Velg Lagre for å bruke kildevalgene eller Avbryt for å forkaste dem.
Treningsøkter
Velg Treningsøkter for å eksportere treningsposter. Inkluder rutedata legger til tilgjengelige rutepunkter i JSON-treningsdata. Det oppretter ikke separate GPX-opplastinger.
For Versjon 2 slår du på Inkluder treningsmål for å legge til målinger som puls, aktiv energi og steg. Velg Minutter eller Sekunder for Tidsgruppering for treningsmål; sekunder gir mer detaljer og større eksporter. Versjon 1 inkluderer alltid treningsmål.
Eksportinnstillinger
Eksportformat
- JSON bevarer strukturerte data for integrasjoner og analyse.
- CSV oppretter tabellfiler for regneark.
- Markdown oppretter lesbare overskrifter og tabeller for notater og arkiver.
Eksportversjon
Velg Versjon 2 for den aktuelle datastrukturen. Bruk Versjon 1 når en eksisterende arbeidsflyt avhenger av det eldre formatet.
Datointervall
| Valg | Data som inkluderes |
|---|---|
| Standard | Forrige dag og i dag frem til kjøringstidspunktet |
| Siden siste synkronisering | Siden forrige synkronisering frem til kjøringstidspunktet |
| I dag | I dag frem til kjøringstidspunktet |
| I går | Forrige hele dag |
| Forrige 7 dager | De forrige sju hele dagene |
Summer data og tidsgruppering
For JSON + Helsemål slår du på Summer data for å kombinere målinger i tidsgrupper, eller av for enkeltmålinger der det er tilgjengelig. Summeringen avhenger av målet—for eksempel summeres steg og vektmålinger gjennomsnittsberegnes. CSV-eksporter av helsemål bruker summerte data.
Når Tidsgruppering er tilgjengelig, velger du hvor mye detaljer du vil beholde. Time- eller dagsgrupper gir færre rader enn minutt- eller sekundgrupper. Tilgjengelige valg avhenger av datointervall og format. Tidsgruppering for treningsøkter konfigureres separat under Treningsøkter.
Batchforespørsler og store nyttelaster
For REST API + JSON slår du på Batchforespørsler for å sende data over flere forespørsler. Bruk dette når endepunktet avviser store brødtekster eller store forespørsler får timeout. Den mottakende tjenesten må håndtere hver forespørsel separat.
Batching er ikke tilgjengelig for CSV og Markdown. Det reduserer størrelsen på enkeltforespørsler, men reduserer ikke mengden helsedata enheten må lese. Se Ytelse hvis forberedelsen er treg.
Planlegg påminnelser
Hvis du vil ha en oppfordring til å låse opp og åpne appen, slår du på Aktiver påminnelser. Velg Hver time, Hver dag eller Valgte dager, og angi deretter minutt, tid og dager etter behov. Tillat varslingstilgang når du blir bedt om det; hvis tilgang nektes, bruker du Åpne varslingsinnstillinger.
En påminnelse kjører ikke automatiseringen og bekrefter ikke en vellykket synkronisering. Trykk på den for å åpne automatiseringen, eller bruk Åpne og synkroniser på varselet for å be om en kjøring. Automatiseringen må være aktivert; en påminnelse kan fortsatt vises etter en vellykket bakgrunnskjøring. Endringer i påminnelser gjelder når du lagrer.
Synkroniseringsfrekvens og lagre
Velg et tall og Minutter, Timer, Dager eller Uker under Synkroniseringsfrekvens—for eksempel hvert 15. minutt. Dette er en ønsket bakgrunnskadens, ikke en garantert tidsplan.
Enheten må være ulåst når helsedata leses. Aktiver Bakgrunnsoppdatering for Health Auto Export og slå av Lavstrømsmodus for automatiske kjøringer. iOS kan fortsatt forsinke kjøringer når enheten har vært inaktiv eller systemressursene er begrenset.
Slå på Aktivert når du er klar for automatiske kjøringer, og velg deretter Oppdater for å lagre automatiseringen. Du kan umiddelbart laste opp et valgt datointervall med trinnene nedenfor.
Forespørselshoder
Appen angir Content-Type for det valgte formatet og inkluderer:
| Hode | Betydning |
|---|---|
automation-name |
Automatiseringsnavn |
automation-id |
Automatiseringsidentifikator |
automation-aggregation |
Valgt tidsgruppering |
automation-period |
Valgt datointervall |
session-id |
Forespørselsidentifikator |
Eksportere historiske eller manglende data
Bruk Manuell opplasting når du først konfigurerer automatiseringen for å eksportere historiske data, eller senere for å dekke datoer den automatiske synkroniseringen har misset. Du kan også bruke den for å sjekke konfigurasjonen.
- Åpne automatiseringen og velg Manuell opplasting under Eksporter eksisterende data.
- Angi datoene Start og Slutt, og velg deretter Start eksport.
- Sjekk endepunktets mottatte forespørsel, hoder og brødtekst.
Feilsøking
- Ingen forespørsel mottatt: Sjekk URL, nettverkstilgjengelighet og serverlogger.
- Autentiseringsfeil: Sjekk hodenøkkelen, tokenet og endepunkttillatelser.
- Nyttelast avvist eller timeout: Sjekk serverens størrelsesgrenser, bruk batching for JSON eller reduser eksportstørrelsen.
Åpne automatiseringen og velg Vis aktivitetslogger for å gjennomgå en kjøring. Advarsler markerer mulige problemer som treg datahenting; feil identifiserer mislykkede trinn. For hjelp til å rapportere et problem, se Få hjelp.