Apple Health-gegevens synchroniseren naar REST API

REST API-automatiseringen stellen u in staat om uw gezondheidsgegevens automatisch te exporteren naar elke webservice die HTTP POST-verzoeken accepteert. Dit is ideaal voor integratie met aangepaste backends, API's van derden of webhooks.

Overzicht

REST API-automatiseringen sturen uw gezondheidsgegevens naar een opgegeven URL-endpoint met behulp van HTTP POST-verzoeken. De automatisering kan gegevens verzenden in JSON- of CSV-formaat, met configureerbare headers voor authenticatie en aangepaste metadata.

Gebruikssituaties:

• Integratie met aangepaste backend-services
• Gegevens verzenden naar webhooks
• Synchronisatie met API's van derden
• Aangepaste dashboards of analyseplatforms bouwen

Belangrijkste functies:

• Ondersteunt zowel JSON- als CSV-formaten
• Aangepaste HTTP-headers voor authenticatie
• Configureerbare verzoek-timeout
• Handmatige export van historische gegevens

Beperkingen

• Toegang tot gezondheidsgegevens: Apps mogen geen toegang krijgen tot gezondheidsgegevens terwijl de iPhone vergrendeld is. Automatiseringen worden alleen uitgevoerd tijdens perioden waarin uw apparaat ontgrendeld is. Dit kan de actualiteit van gegevens beïnvloeden. Zie instructies voor handmatige synchronisatie om gegevens up-to-date te houden.

• Achtergrondverwerking: iOS beperkt achtergrondverwerking om de batterijduur te behouden. Automatiseringen zijn afhankelijk van App-vernieuwing op achtergrond en worden mogelijk niet onmiddellijk uitgevoerd als:

  • App-vernieuwing op achtergrond is uitgeschakeld voor de app
  • Het apparaat zich in de energiebesparende modus bevindt
  • Het apparaat gedurende langere perioden inactief is geweest
  • Systeembronnen beperkt zijn
  • Meerdere apps concurreren om achtergronduitvoeringstijd

Vereisten

• Een geldig URL-endpoint dat HTTP POST-verzoeken accepteert
• Authenticatiegegevens (indien vereist door uw endpoint)
• Netwerkverbinding om uw endpoint te bereiken

Configuratie

Navigeer naar het scherm Geautomatiseerde exports vanuit de hoofdnavigatie, tik vervolgens op "Nieuwe automatisering" en selecteer "REST API" als Automatiseringstype.

Automatiseringsnaam

Voer een beschrijvende naam in voor uw automatisering (bijvoorbeeld "Mijn Backend API", "Webhook-integratie").

Meldingen

Configureer wanneer u meldingen wilt ontvangen:

• Melden bij cache-update - Ontvang een melding wanneer gecachte gegevens worden bijgewerkt
• Melden bij uitvoering - Ontvang een melding telkens wanneer de automatisering wordt uitgevoerd

URL-configuratie

Voer de volledige URL in waar u uw gezondheidsgegevens naartoe wilt sturen. Dit moet een volledige URL zijn inclusief het protocol (http:// of https://).

Voorbeeld-URL's:

• https://api.example.com/health-data
• https://webhook.site/your-unique-id
• http://localhost:3000/api/health

Opmerking: De URL moet geldig zijn en toegankelijk vanaf uw apparaat. Ongeldige URL's voorkomen dat de automatisering wordt uitgevoerd.

Verzoek-timeout

Selecteer een timeout-interval voor HTTP-verzoeken. Dit bepaalt hoe lang de app wacht op een antwoord voordat het verzoek als mislukt wordt beschouwd.

HTTP-headers

Voeg aangepaste HTTP-headers toe voor authenticatie of metadata. Veelvoorkomende gebruikssituaties zijn:

• API-sleutels: X-API-Key: your-api-key
• Autorisatietokens: Authorization: Bearer your-token
• Content-type overschrijvingen: Content-Type: application/json

Om headers toe te voegen:

1. Tik op "Headers toevoegen"
2. Voer de header-sleutel in het linkerveld in
3. Voer de header-waarde in het rechterveld in
4. Herhaal voor aanvullende headers

Belangrijk: Elke header-sleutel moet een bijbehorende waarde hebben. Lege headers worden genegeerd.

Gegevenstype-instellingen

Gegevenstype

Selecteer welk type gezondheidsgegevens u wilt exporteren:

• Gezondheidsmetrieken - Stappen, hartslag, slaap en andere gezondheidsmetingen
• Trainingen - Oefen- en fitnessactiviteiten
• Symptomen - Gezondheidssymptomen en -aandoeningen
• ECG - Elektrocardiogrammetingen
• Hartslagmeldingen - Hoge/lage hartslaggebeurtenissen
• Gemoedstoestand - Stemmings- en mentale toestandsinvoeren (iOS 18.0+)
• Cyclusvolging - Menstruatiecyclus- en reproductieve gezondheidsgegevens
• Medicijnen - Medicijnlogboeken en naleving (iOS 26.0+)

Configuratie gezondheidsmetrieken

Wanneer Gezondheidsmetrieken is geselecteerd:

Selecteer gezondheidsmetrieken - Kies welke specifieke metrieken u wilt opnemen. U kunt alle beschikbare metrieken selecteren of specifieke kiezen.

Tip: Alleen de metrieken selecteren die u nodig heeft, kan de verwerkingstijd verbeteren en de gegevensgrootte verminderen.

Voorkeursbronnen - Configureer welke gegevensbronnen prioriteit hebben wanneer meerdere bronnen dezelfde metriek leveren.

Configuratie trainingen

Wanneer Trainingen is geselecteerd:

Routegegevens opnemen - Schakel AAN om routes op te nemen voor trainingen die locatiegegevens hebben.

Trainingsmetrieken opnemen - Schakel AAN om gezondheidsmetrieken op te nemen die tijdens trainingen zijn verzameld (hartslag, calorieën, enz.).

Tijdsgroepering (trainingsmetrieken) - Bij gebruik van Exportversie 2 en wanneer Trainingsmetrieken opnemen is ingeschakeld:

• Minuten - Groepeert trainingsmetrieken per minuut
• Seconden - Groepeert trainingsmetrieken per seconde

Exportinstellingen

Exportformaat

Selecteer het formaat voor uw geëxporteerde gegevens:

• JSON-formaat - Biedt gedetailleerde gegevensstructuren met geneste objecten. Het beste voor API's, databases en applicaties die gestructureerde gegevens nodig hebben. JSON-formaat bevat meer gedetailleerde informatie voor complexe gegevenstypen zoals slaapfasen en AFib-metingen.

• CSV-formaat - Biedt tabelgegevens die eenvoudig kunnen worden geïmporteerd in spreadsheetapplicaties. Het beste voor eenvoudige gegevensanalyse of wanneer uw endpoint CSV-gegevens verwacht.

Opmerking: De Content-Type-header wordt automatisch ingesteld op application/json voor JSON-exports en multipart/form-data voor CSV-exports.

Exportversie

Selecteer een Exportversie. Versiebeheer maakt het mogelijk om in uw eigen tempo over te schakelen tussen bijgewerkte versies van de export en minimaliseert wijzigingen die workflows verstoren.

• Versie 1 - Legacy-formaat, gebruik dit als u bestaande workflows heeft die afhankelijk zijn van dit formaat
• Versie 2 - Huidig formaat met verbeterde trainingsgegevens en meer gedetailleerde metadata-opties

Datumbereik

Selecteer wanneer gegevens moeten worden geëxporteerd:

• Standaard - Synchroniseert gegevens voor de volledige vorige dag plus gegevens tot de huidige datum en tijd
• Sinds laatste synchronisatie - Bij elke synchronisatie worden alle gegevens geëxporteerd sinds de laatste keer dat de export werd uitgevoerd tot de huidige datum en tijd
• Vandaag - Synchroniseert alle gegevens voor de huidige datum tot de huidige tijd
• Gisteren - Synchroniseert alle gegevens voor de volledige vorige dag
• Afgelopen 7 dagen - Synchroniseert gegevens voor de volledige afgelopen zeven dagen

Gegevens samenvatten

Bij gebruik van JSON-formaat met gegevenstype Gezondheidsmetrieken, schakel Gegevens samenvatten AAN of UIT.

• AAN - Biedt geaggregeerde gegevenssamenvattingen
• UIT - Biedt gedisaggregeerde gegevens waar mogelijk, met individuele gegevenspunten

Opmerking: Deze instelling is alleen van toepassing op JSON-formaat met Gezondheidsmetrieken. Gegevens worden altijd geaggregeerd bij gebruik van CSV-formaat of wanneer meerdere metrieken zijn geselecteerd.

Tijdsgroepering

Bij gebruik van JSON-formaat met Gegevens samenvatten ingeschakeld, selecteer hoe gegevens moeten worden geaggregeerd.

Opmerking: CSV-formaat aggregeert altijd gegevens. Aggregatie op minuut- en seconde-niveau kan de verwerkingstijd en gegevensgrootte aanzienlijk verhogen.

Batch-verzoeken

Bij gebruik van JSON-formaat, schakel Batch-verzoeken AAN om gegevens in batches over meerdere verzoeken te verzenden in plaats van een enkele payload.

• AAN - Verspreidt gegevens over meerdere verzoeken om buitensporig grote payloads te vermijden
• UIT - Verzendt alle gegevens in een enkel verzoek

Synchronisatiefrequentie

Configureer hoe vaak de automatisering gegevens moet uploaden:

Selecteer een getal en interval.

Testen en verificatie

Handmatig testen

1. Tik op "Handmatige export" in het automatiseringsconfiguratiescherm
2. Selecteer een datumbereik
3. Tik op "Exporteren" om een testverzoek te verzenden
4. Controleer uw endpoint om te bevestigen dat de gegevens zijn ontvangen

Activiteitenlogboeken bekijken

1. Tik op "Activiteitenlogboeken bekijken" in het automatiseringsconfiguratiescherm
2. Bekijk recente automatiseringsuitvoeringen
3. Controleer op fouten of waarschuwingen
4. Verifieer verzoektijdstempels en responsestatus

Gegevensformaat verifiëren

De app voegt automatisch deze headers toe aan elk verzoek:

• Content-Type - Ingesteld op basis van exportformaat
• automation-name - De naam van uw automatisering
• automation-id - Unieke identifier voor de automatisering
• automation-aggregation - De geselecteerde tijdsgroepering
• automation-period - Het geselecteerde datumbereik
• session-id - Unieke identifier voor elk verzoek

Problemen oplossen

Veelvoorkomende problemen

Gegevens niet ontvangen bij endpoint

• Verifieer dat de endpoint-URL correct is
• Controleer of uw endpoint POST-verzoeken accepteert
• Controleer authenticatieheaders
• Controleer endpoint-logboeken op inkomende verzoeken
• Verifieer netwerkverbinding

Tips en best practices

1. Prestaties:

   • Gebruik passende tijdsgroepering om detail vs. gegevensgrootte in balans te brengen
   • Selecteer alleen de metrieken die u nodig heeft

2. Betrouwbaarheid:

   • Stel passende timeout-waarden in op basis van de responstijd van uw endpoint
   • Monitor activiteitenlogboeken regelmatig

3. Gegevensformaat:

   • Gebruik JSON voor gestructureerde gegevens en API's
   • Gebruik CSV voor eenvoudige gegevensanalyse of spreadsheetintegratie
   • Overweeg batch-verzoeken voor grote datasets of gescheiden verwerking