Apple Health-gegevens synchroniseren met REST API
Stuur gezondheidsgegevens naar een REST API-eindpunt.
Laatst bijgewerkt: 31 oktober 2026
Op deze pagina
Exportinstellingen
Exportinstellingen ExportformaatExportversieDatumbereikGegevens samenvatten en tijdgroeperingStuur gezondheidsexporten naar een eindpunt dat HTTP POST-verzoeken accepteert.
Belangrijk — beperkingen van automatiseringen: Je apparaat moet ontgrendeld zijn om gezondheidsgegevens te lezen, en iOS garandeert geen achtergronduitvoeringen met de door jou gekozen frequentie. Lees de beperkingen van automatiseringen voordat je op automatische exporten vertrouwt.
De automatisering openen
Open Exporteren → Geautomatiseerd op iPhone, of Automatiseringen in de iPad-zijbalk. Selecteer Nieuwe automatisering, of open een bestaande om te bewerken.
Naam, status en meldingen
Voer een naam in die deze automatisering identificeert. Ingeschakeld staat automatische uitvoeringen toe; laat dit uit tot je klaar bent.
Kies de uitvoeringsmeldingen die je wilt:
- Melden bij cache-update meldt dat exportgegevens zijn voorbereid.
- Melden bij uitvoering meldt een geslaagde upload naar je eindpunt.
Sta meldingen toe wanneer daarom wordt gevraagd. Deze meldingen rapporteren activiteit; ze plannen geen uitvoering.
Het eindpunt instellen
- Kies REST API als Automatiseringstype.
- Voer een URL in die bereikbaar is vanaf je iPhone of iPad, bijvoorbeeld
https://api.example.com/health-data. - Voeg eventuele vereiste authenticatie toe onder HTTP-headers. Gebruik bijvoorbeeld
Authorizationals sleutel enBearer YOUR_TOKENals waarde. - Kies een verzoektimeout die past bij je eindpunt.
Elke header heeft zowel een sleutel als een waarde nodig. Voor een server op een ander apparaat gebruik je het bereikbare netwerkadres in plaats van localhost.
Instellingen gegevenstype
Selecteer één gegevenstype voor deze automatisering: Gezondheidsmetrieken, Trainingen, Symptomen, ECG, Hartslagmeldingen, Gemoedstoestand, Cyclustracking of Medicijnen. Gemoedstoestand vereist iOS 18 of nieuwer; Medicijnen vereist iOS 26 of nieuwer en aparte medicijnentoegang.
Gezondheidsmetrieken
Kies Gezondheidsmetrieken, open Gezondheidsmetrieken selecteren en selecteer de metingen die je nodig hebt.
Om metingen te beperken tot bepaalde apps of apparaten, open je Voorkeursbronnen, kies je een metriek en selecteer je de bronnen. Alles staat elke bron toe die niet is uitgesloten. Gebruik Uitgesloten bronnen om een bron voor de gezondheidsmetrieken van deze automatisering te negeren. Uitsluitingen hebben voorrang; een niet-geselecteerde bron wordt niet vervangen wanneer een voorkeursbron geen gegevens heeft. Selecteer Bewaar om de bronkeuzes toe te passen of Annuleer om ze te verwerpen.
Trainingen
Kies Trainingen om trainingsrecords te exporteren. Routgegevens opnemen voegt beschikbare routepunten toe aan JSON-trainingsgegevens. Het maakt geen aparte GPX-uploads.
Voor Versie 2 schakel je Trainingsmetrieken opnemen in om metingen zoals hartslag, actieve energie en stappen toe te voegen. Kies Minuten of Seconden voor de tijdgroepering van trainingsmetrieken; seconden leveren meer detail en grotere exporten. Versie 1 bevat altijd trainingsmetrieken.
Exportinstellingen
Exportformaat
- JSON bewaart gestructureerde gegevens voor integraties en analyse.
- CSV maakt tabulaire bestanden voor spreadsheets.
- Markdown maakt leesbare koppen en tabellen voor notities en archieven.
Exportversie
Kies Versie 2 voor de huidige gegevensstructuur. Gebruik Versie 1 wanneer een bestaande workflow van het oudere formaat afhangt.
Datumbereik
| Selectie | Opgenomen gegevens |
|---|---|
| Standaard | De vorige dag en vandaag tot de uitvoeringstijd |
| Sinds laatste synchronisatie | Sinds de vorige synchronisatie tot de uitvoeringstijd |
| Vandaag | Vandaag tot de uitvoeringstijd |
| Gisteren | De volledige vorige dag |
| Vorige 7 dagen | De vorige zeven volledige dagen |
Gegevens samenvatten en tijdgroepering
Voor JSON + Gezondheidsmetrieken schakel je Gegevens samenvatten in om metingen in tijdgroepen te combineren, of uit voor individuele metingen waar beschikbaar. De samenvatting hangt af van de metriek—bijvoorbeeld stappen worden opgeteld en gewichtsmetingen gemiddeld. CSV-exporten van gezondheidsmetrieken gebruiken samengevatte gegevens.
Wanneer Tijdgroepering beschikbaar is, kies je hoeveel detail je wilt behouden. Groepen per uur of dag leveren minder rijen op dan minuut- of secondengroepen. Beschikbare keuzes hangen af van het datumbereik en formaat. Tijdgroepering van trainingen wordt apart geconfigureerd onder Trainingen.
Batchverzoeken en grote payloads
Voor REST API + JSON schakel je Batchverzoeken in om gegevens over meerdere verzoeken te sturen. Gebruik dit wanneer je eindpunt grote bodies weigert of grote verzoeken een timeout krijgen. De ontvangende service moet elk verzoek apart afhandelen.
Batchen is niet beschikbaar voor CSV en Markdown. Het verkleint individuele verzoeken, maar niet de hoeveelheid gezondheidsgegevens die het apparaat moet lezen. Zie Prestaties als de voorbereiding traag is.
Herinneringen plannen
Als je een melding wilt om te ontgrendelen en de app te openen, schakel dan Herinneringen inschakelen in. Kies Elk uur, Elke dag of Geselecteerde dagen, en stel de minuut, tijd en dagen in. Sta meldingen toe wanneer daarom wordt gevraagd; als toegang is geweigerd, gebruik Meldingsinstellingen openen.
Een herinnering voert de automatisering niet uit en bevestigt geen geslaagde synchronisatie. Tik erop om de automatisering te openen, of gebruik Openen en synchroniseren op de melding om een uitvoering aan te vragen. De automatisering moet ingeschakeld zijn; een herinnering kan nog verschijnen na een geslaagde achtergronduitvoering. Wijzigingen in herinneringen gelden wanneer je opslaat.
Synchronisatiefrequentie en opslaan
Kies een getal en Minuten, Uren, Dagen of Weken onder Synchronisatiefrequentie—bijvoorbeeld elke 15 minuten. Dit is een gewenste achtergrondcadans, geen gegarandeerd schema.
Je apparaat moet ontgrendeld zijn wanneer gezondheidsgegevens worden gelezen. Schakel Achtergrond-app verversen in voor Health Auto Export en schakel de energiebesparingsmodus uit voor automatische uitvoeringen. iOS kan uitvoeringen nog steeds vertragen wanneer het apparaat inactief is geweest of systeembronnen beperkt zijn.
Schakel Ingeschakeld in wanneer je klaar bent voor automatische uitvoeringen, en selecteer Werk bij om de automatisering op te slaan. Je kunt meteen een geselecteerd datumbereik uploaden met de stappen hieronder.
Verzoekheaders
De app stelt Content-Type in voor het gekozen formaat en neemt op:
| Header | Betekenis |
|---|---|
automation-name |
Automatiseringsnaam |
automation-id |
Automatiseringsidentificatie |
automation-aggregation |
Geselecteerde tijdgroepering |
automation-period |
Geselecteerd datumbereik |
session-id |
Verzoekidentificatie |
Historische of gemiste gegevens exporteren
Gebruik Handmatige upload wanneer je de automatisering voor het eerst instelt om historische gegevens te exporteren, of later om datums te dekken die de automatische synchronisatie heeft gemist. Je kunt dit ook gebruiken om je installatie te controleren.
- Open de automatisering en selecteer Handmatige upload onder Bestaande gegevens exporteren.
- Stel de datums Start en Einde in en selecteer Export starten.
- Controleer het ontvangen verzoek, de headers en de body op je eindpunt.
Problemen oplossen
- Geen verzoek ontvangen: Controleer de URL, netwerkbereikbaarheid en serverlogboeken.
- Authenticatiefout: Controleer de headersleutel, het token en de eindpuntmachtigingen.
- Payload geweigerd of timeout: Controleer de grootelimieten van de server, gebruik batchen voor JSON, of verklein de export.
Open de automatisering en selecteer Activiteitslogboeken weergeven om een uitvoering te bekijken. Waarschuwingen markeren mogelijke problemen zoals trage gegevensopvraging; fouten identificeren mislukte stappen. Voor hulp bij het melden van een probleem zie Hulp krijgen.