Hoe stuur ik Apple Health-data automatisch naar een webhook?

Installeer de Life Dashboard-app op je iPhone, voeg je URL toe met Bestemming toevoegen op het tabblad Gezondheid en kies onder Wat versturen welke Apple Health-types je wilt versturen. Vanaf dan leest de app Apple Health (de app Gezondheid op je iPhone) op de achtergrond, volgens het schema dat je instelt, en post hij elk nieuw record als JSON naar je URL: stappen, slaap met slaapfasen, hartslag, HRV, gewicht, bloeddruk, work-outs en meer, 28 types in totaal, elk record met een vaste uuid en de app of het apparaat dat het schreef.

Stel je een geheim in, dan is elk verzoek ondertekend met HMAC-SHA256 in een X-Signature-header. Een payload die niet kan worden afgeleverd, wacht in een wachtrij op de iPhone, en een record dat je in Apple Health verwijdert, wordt in de volgende payload genoemd. De payload is die van de Android-app, dus één ontvanger werkt voor een iPhone en een Android-telefoon.

iPhone of Apple WatchApple HealthLife Dashboard-appJe URL

Door Owen Vogelaar, de maker van Life Dashboard 10 min leestijd

Download de iPhone-app

Waarom er een app op de iPhone voor nodig is

Apple Health heeft geen web-API. De data staat op de iPhone en apps lezen die via HealthKit van Apple, dus iets op de iPhone moet de data lezen en doorsturen. De Life Dashboard-app doet dat en post rechtstreeks naar de URL's die je invult. Er is geen account en er zit geen server van Life Dashboard tussen, en de app heeft geen analytics, crashrapportage of advertenties. Een web-API voor Health Connect of Apple Health legt er meer over uit.

Wat je nodig hebt

  • Een iPhone met iOS 17 of nieuwer, en Life Dashboard voor iPhone. Hij staat in de App Store voor € 6,99 eenmalig (US$ 5,99), zonder abonnement. Zelf bouwen uit de broncode met Xcode kost niets extra als je al lid bent van het Apple Developer Program.
  • Een server die een JSON-POST accepteert. Gebruik https://. iOS staat onversleuteld http:// alleen toe naar een IP-adres, een .local-naam of een naam zonder punt, bedoeld voor je eigen netwerk.

Zo stel je het in

  1. Vul bij het instellen van de app je URL in als Webhook-URL. Later tik je op Bestemming toevoegen op het tabblad Gezondheid, vul je de URL in en tik je op Webhook toevoegen. Je kunt er meerdere toevoegen; een sync telt als afgeleverd zodra één ervan hem accepteert.
  2. Optioneel: tik op de bestemming op het tabblad Gezondheid. Tik onder Eigen headers op Header toevoegen voor een Authorization-header of een API-sleutel. Vul een HMAC-ondertekeningsgeheim in dat je server ook kent, of tik op Genereren en Geheim kopiëren. Tik daarna op Bewaren. Elk adres heeft zijn eigen geheim en headers.
  3. Tik op Testping bij het instellen, of op Test versturen in het paneel van de bestemming. Dat verstuurt een kleine payload met "test": true en zonder records, met wat er is bewaard. Staat je server thuis, sta dan Lokaal netwerk toe als iOS erom vraagt.
  4. Zet onder Wat versturen je types aan en geef toegang tot Apple Health. Voorbeeld van payload laat daar de laatste 7 dagen zien zoals de payload eruit zou zien, en Nu synchroniseren op het tabblad Gezondheid verstuurt wat nieuw is. De eerste sync van een type verstuurt de laatste 7 dagen.
  5. Voor oudere data tik je op Geschiedenis versturen onder Wat versturen en kies je hoe ver terug, van 30 dagen tot Alles.
Een webhookbestemming in de iPhone-app, met het ondertekeningsgeheim en eigen headers

Hoe de POST eruitziet

Elk verzoek is een JSON-POST. Een ingekorte payload, van de payloadpagina van de iOS-app:

{
  "timestamp": "2026-02-05T12:00:00Z",
  "timezone": "Europe/Amsterdam",
  "app_version": "1.9.0",
  "source": "healthkit_ios",
  "sequence": 42,
  "steps": [
    {
      "count": 1234,
      "start_time": "2026-02-05T08:00:00Z",
      "end_time": "2026-02-05T09:00:00Z",
      "uuid": "5B7A0C2E-8F3D-4B1A-9C6E-2D4F8A1B3C5D",
      "source": "Alex's iPhone"
    }
  ],
  "daily_totals": [
    { "date": "2026-02-05", "steps": 8421, "distance_meters": 6210.4 }
  ]
}
  • source op het hoogste niveau is healthkit_ios, waar de Android-app health_connect zegt.
  • timezone is de tijdzone van de iPhone op het moment dat de payload werd opgebouwd. Elke tijd in de payload is UTC, en dit is de zone waarin daily_totals hun dagen afbakenen, zodat een ontvanger de lokale dag kent na de overgang naar zomer- of wintertijd of na een reis. Sinds versie 1.9.0 staat het veld in elke payload.
  • sequence gaat met één omhoog bij elke payload die de iPhone opbouwt, en een nieuwe poging houdt het nummer waarmee de payload is opgebouwd.
  • Elk record heeft een uuid, die van het Apple Health-sample zelf, die gelijk blijft zolang het record bestaat, en een source: de naam die Apple Health geeft aan de app of het apparaat dat het schreef. Voor data die de iPhone of de Watch zelf vastlegt, is dat de naam van het apparaat, en daar zit vaak de naam van de eigenaar in.
  • daily_totals bevat stappen, afstand en calorieën per lokale dag, voor vandaag en de twee dagen ervoor, berekend met de statistieken van Apple Health zelf. Een wandeling die zowel de iPhone als de Watch heeft vastgelegd, telt daar één keer; tel je losse records op, dan telt hij dubbel.

De sleutels, velden en eenheden zijn die van de Android-app. De payload-referentie van de Android-app beschrijft elk type, en het JSON Schema ervan geldt voor beide apps. Datatypes van Apple Health zet per sleutel op een rij wat een iPhone verstuurt.

De handtekening controleren

Met een geheim ingesteld heeft elke POST de header X-Signature: sha256=<hex>, de HMAC-SHA256 van de ruwe request-body met je geheim als sleutel. Het is hetzelfde schema als dat van de Android-app, dus één controle werkt voor beide telefoons. Bereken hem over de bytes zoals ze binnenkwamen, voordat je ze parset, vergelijk in constante tijd en antwoord met 401 als hij niet klopt. In Node.js:

const crypto = require('crypto');

function verifySignature(req, secret) {
  const expected = 'sha256=' + crypto
    .createHmac('sha256', secret)
    .update(req.rawBody) // the exact raw request body bytes
    .digest('hex');
  const actual = req.get('X-Signature') || '';
  return actual.length === expected.length &&
    crypto.timingSafeEqual(Buffer.from(actual), Buffer.from(expected));
}

In Python:

expected = "sha256=" + hmac.new(SECRET, body, hashlib.sha256).hexdigest()
valid = hmac.compare_digest(expected.encode(), presented.encode())

Staat je server achter een reverse proxy die een clientcertificaat eist, importeer dat dan als .p12-bestand onder Meer > Geavanceerd. Het blijft in de sleutelhanger van de iPhone, en elke webhook waarvan de server om een certificaat vraagt krijgt het, ook op de achtergrond.

Nieuwe pogingen en de wachtrij

  • Nieuwe pogingen. Elke 2xx telt als afgeleverd. Bij een netwerkfout, een time-out, 408, 429 of 5xx probeert de app het in totaal 3 keer, met eerst 1 en dan 2 seconden ertussen. Andere fouten, zoals 401 of 404, mislukken meteen. Een poging stopt zodra de verbinding 10 seconden stilstaat, dus antwoord eerst en sla daarna pas op.
  • De wachtrij. Elke payload komt op de iPhone in de wachtrij voordat hij wordt gepost, zodat er niets verloren gaat bij een sync die iOS halverwege afbreekt. Een payload die niet is afgeleverd gaat opnieuw de deur uit als het netwerk terug is, bij de volgende sync of met Nu opnieuw proberen, de oudste eerst, naar de URL's en met de headers die op dat moment zijn ingesteld. De wachtrij stopt bij de eerste payload die mislukt, zodat de rest zijn volgorde houdt.
  • Geweigerde payloads. Een payload die je server weigert met 400, 413 of 422 houdt de payloads erna niet tegen. Hij blijft in de wachtrij en wordt één keer per dag opnieuw aangeboden. Payloads die later in de wachtrij kwamen, kunnen dan eerder aankomen: gebruik sequence om de volgorde te bepalen.
  • Oude en vervallen payloads. Een payload ouder dan 7 dagen vervalt als je server de volgende aflevering ervan met een fout beantwoordt, nooit terwijl de iPhone offline is. De wachtrij bevat hooguit 700 payloads; daarboven vervalt de oudste. Elke vervallen payload krijgt een regel op het tabblad Logs en een melding.
  • Redirects worden alleen gevolgd binnen dezelfde host. Een redirect naar een andere host, zoals een inlogpagina vóór je server, telt als mislukte aflevering, en de log noemt de host waar hij naar wees.
Het tabblad Logs van de iPhone-app, met een regel per verzending

Verwijderde records

Van een record dat in Apple Health is verwijderd, valt bij een sync niets meer te lezen. Daarom volgt de app de lijst van verwijderingen die Apple Health zelf bijhoudt en noemt hij in de volgende payload wat er weg is, met de sleutel waaronder het record aankwam en de uuid waarmee het is afgeleverd:

"deleted_records": [
  { "type": "nutrition", "uuid": "84E37E8A-1C2D-4E5F-8A9B-0C1D2E3F4A5B" }
]
  • Is een verwijdering de enige wijziging, dan verstuurt de sync een payload met deleted_records en zonder records.
  • Apple Health past een bestaand record nooit aan. Een app die een record bewerkt, verwijdert het en bewaart een nieuw record onder een nieuwe uuid, dus een bewerking komt aan als een verwijdering plus een nieuw record.
  • Een verwijdering bij slaap noemt één fase, niet de nacht. Haal die fase weg, of vervang de nachten die in een nieuwere payload zitten.
  • deletions_unavailable noemt de sleutels waarvoor een payload niet kan instaan, bijvoorbeeld als Apple Health niet op tijd antwoordde of als een type langer dan 7 dagen niet is gelezen. Trek die recht met een backfill, waarmee de app je oude data alsnog verstuurt.

Wanneer de app verstuurt

Onder Wanneer versturen stel je een interval in van 15 minuten of langer, standaard 60, of vaste tijden op de dag, op de dagen die je kiest, met stille uren. iOS bepaalt wanneer een app op de achtergrond draait, dus een vaste tijd betekent "niet eerder dan". Apple Health wekt de app ook als een ingeschakeld type nieuwe data heeft, hooguit zo vaak als Apple voor dat type toestaat. Ververs op achtergrond moet voor de app aanstaan; de energiebesparingsmodus zet het uit.

Wil je een sync op een exacte minuut, maak dan in Opdrachten een automatisering die op dat tijdstip Gezondheidsdata synchroniseren uitvoert. Dezelfde taak werkt bij thuiskomst, met je stem via Siri, vanuit de widget op het beginscherm en, op iOS 18 en nieuwer, vanuit een regelaar in het bedieningspaneel. Hij verstuurt wat in de wachtrij staat en wat nieuw is.

iOS versleutelt Apple Health terwijl de iPhone vergrendeld is, dus een sync die dan begint wacht tot je hem ontgrendelt.

Wanneer versturen in de iPhone-app, op vaste tijden met stille uren

Backfill

Geschiedenis versturen onder Wat versturen verstuurt de periode die je kiest, van 30 dagen tot je hele geschiedenis, in vensters van 3 dagen, de oudste eerst, met de velden backfill, window_start, window_end en window_complete. De records zijn dezelfde als bij een sync, met dezelfde uuid, dus de overlap kun je ontdubbelen. window_complete is vanaf een iPhone altijd false, omdat Apple Health een app niet vertelt welke types hij niet mag lezen. Backfill-payloads gaan alleen naar webhooks, nooit naar MQTT of de wachtrij.

Ontvangers die werken

  • De Life Dashboard-stack. Een ontvanger die X-Signature controleert, Postgres en Grafana-dashboards, uit één compose-bestand. Scan de QR-code van de stack in de app om te koppelen. Zie de Life Dashboard-stack.
  • n8n. Een Webhook-node met Raw Body aan, een handtekeningcontrole in een Code-node en een 204. In Apple Health naar n8n staat de workflow.
  • Node-RED. Een http in-node met Do not parse request body aan (Node-RED 4.1 of nieuwer) geeft de ruwe bytes voor de HMAC.
  • Home Assistant. De Life Dashboard-integratie maakt van de payload sensoren en langetermijnstatistieken.
  • Een eigen script. De payload-referentie van de Android-app heeft voorbeeldontvangers in Python en Node.js.

Opslaan

  • Doe voor elk record een upsert op de sleutel in de payload en de uuid. Een record kan twee keer aankomen: een backfill verstuurt zijn periode opnieuw, en een aflevering die iOS afbrak gaat opnieuw de deur uit vanuit de wachtrij. Eén sample actieve energie telt mee voor zowel active_calories als total_calories, dus neem beide in je sleutel op.
  • Bewaar daily_totals als één rij per datum, uit de payload met de hoogste sequence waarin die datum zat.
  • De uuid van een slaapnacht komt van de vroegste fase en blijft dus gelijk terwijl de nacht groeit: vervang de nacht als hij langer terugkomt.
  • Verwijder wat deleted_records noemt, op type en uuid, en negeer een uuid die je niet hebt.

Waar een iPhone-payload afwijkt van Android

  • Hartslagvariabiliteit is SDNN, de maat die Apple Health opslaat. Android stuurt RMSSD onder dezelfde sleutel; dat is niet hetzelfde getal.
  • Het type van een work-out is een naam, zoals running of hiit; Android stuurt een nummer als string.
  • Bij de slaapfasen zit in_bed, de tijd in bed rond de fasen, die alleen een iPhone verstuurt.
  • Er is geen schermtijd-payload en geen _diagnostics-blok.

Een ontvanger die voor Android is geschreven werkt ongewijzigd, zolang hij die velden als optioneel behandelt. De payloadpagina van de iOS-app noemt elk verschil.

Life Dashboard voor iPhone

Installeer de app, voeg je URL toe en tik op Testping. Op de iOS-payloadpagina staat alles wat een iPhone verstuurt.

Download in de App Store

€ 6,99 eenmalig in de App Store, geen abonnement.

Zelf bouwen met Xcode

Download de iPhone-app Payload-referentie voor iOS

De open-source iPhone-app die deze gids gebruikt. Geen account, en de data gaat alleen naar de plek die jij aanwijst. Meer over de app.

Veelgestelde vragen

Kan ik Apple Health automatisch exporteren, zonder de app te openen?

Ja. Na het instellen synchroniseert de app op de achtergrond volgens je schema, en Apple Health wekt hem als er nieuwe data is. De iPhone moet ontgrendeld zijn om bij een sync Apple Health te kunnen lezen, en iOS kiest het exacte moment. Voor een vaste minuut gebruik je een automatisering in Opdrachten met Gezondheidsdata synchroniseren.

Kan ik de JSON bekijken voordat ik een ontvanger schrijf?

Ja. Voorbeeld van payload onder Wat versturen toont de laatste 7 dagen als payload, JSON kopiëren zet die op het klembord en Delen geeft hem door als .json-bestand. Data exporteren onder Meer bewaart hetzelfde met Als JSON exporteren, of met Als CSV exporteren als een rij per record.

Hoe voorkom ik dat stappen dubbel worden geteld?

Gebruik daily_totals voor stappen, afstand en calorieën. Die zijn geteld zoals de app Gezondheid ze telt, dus een iPhone en een Watch die allebei een wandeling hebben vastgelegd, tellen hem één keer.

Werkt dezelfde ontvanger ook voor een Android-telefoon?

Ja. Beide apps sturen dezelfde sleutels, eenheden en handtekening. Je houdt ze uit elkaar met source op het hoogste niveau: healthkit_ios of health_connect. Health Connect naar een webhook behandelt de Android-kant.

Stuurt de app iets naar de ontwikkelaar?

Nee. De app heeft geen analytics, crashrapportage of advertenties, en er is geen server van Life Dashboard. De data gaat alleen naar de URL's, de broker of de Home Assistant die je instelt.