Hoe stuur ik Health Connect-data als JSON naar mijn eigen webhook?

Life Dashboard voor Android, een open-source app, leest Health Connect volgens een schema uit en stuurt elke nieuwe meting naar de URL's die je invult, als HTTPS-POST met een JSON-body. Elke payload bevat de metingen van de types die je hebt aangezet (34 in totaal, van stappen en slaapfasen tot hartslag, gewicht en bloeddruk), elk met een stabiele uuid en de app die de meting schreef, plus dagtotalen die een wandeling één keer tellen.

Stel je een geheim in, dan wordt elk verzoek ondertekend met HMAC-SHA256 in een X-Signature-header. Payloads die niet afgeleverd kunnen worden, wachten in een wachtrij op de telefoon op de volgende sync. Elke ontvanger die JSON accepteert werkt, ook n8n, Node-RED, een klein script of de Life Dashboard-stack met Postgres en Grafana.

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

Download de Android-app

Waarom er een app op de telefoon voor nodig is

Health Connect heeft geen web-API. Het is een opslag op de telefoon die apps via Android uitlezen, dus iets op de telefoon moet de data lezen en doorsturen. De Life Dashboard-app doet dat en post rechtstreeks naar je URL, zonder cloudservice of Google-account ertussen. Eén payload bevat elke bron: wat Samsung Health, Google Health (Fitbit en Pixel Watch), Garmin Connect, Oura en Withings naar Health Connect schrijven, waarbij bij elke meting staat welke app die schreef. De cloudroute van Google, de Google Health API, vraagt om een Google Cloud-project en een OAuth-client, en ziet alleen wat in je Google-account terechtkomt.

Wat je nodig hebt

  • Android 9 of nieuwer met Health Connect, en een app die ernaar schrijft, zoals Samsung Health, Garmin Connect of Google Health.
  • Life Dashboard voor Android, uit Google Play voor € 4,99 eenmalig, of gratis via GitHub Releases, Obtainium of F‑Droid. Bij de installatieopties staat elke route.
  • Een server die een JSON-POST via HTTPS accepteert, met een limiet voor de body van minstens 10 MB. Voor onversleutelde HTTP in je eigen netwerk zet je Onversleutelde HTTP-webhooks toestaan aan onder Meer > Geavanceerd.

Health Connect naar je eigen server sturen

  1. Tik op het tabblad Gezondheid op Bestemming toevoegen (is er nog niets ingesteld: Je eigen server gebruiken), plak je URL onder Webhook-URL en tik op Webhook toevoegen. Het tabblad Schermtijd heeft een eigen lijst.
  2. Het adres opent op een eigen pagina. Optioneel: voeg een Authorization-header of API-sleutel toe onder Headers.
  3. Tik onder HMAC-ondertekeningssleutel (optioneel) op Genereren en zet dezelfde waarde op je server. Elk adres heeft een eigen geheim, dus een tweede server krijgt zijn eigen geheim.
  4. Tik bovenaan op Bewaren, open de rij van het adres op het tabblad opnieuw en tik op Test versturen om te controleren of je server het verzoek accepteert.
  5. Geef de Health Connect-rechten en tik op Nu synchroniseren. Met Geschiedenis versturen onder Wat versturen stuur je 30 dagen tot 5 jaar, of Alles.
Een webhookbestemming in de Android-app, met het HMAC-ondertekeningsgeheim en de headers

Hoe de POST eruitziet

Elk verzoek is een POST met Content-Type: application/json; charset=utf-8. Een sync-payload met stappen en hartslag, ingekort:

{
  "timestamp": "2026-10-04T07:15:02.481Z",
  "app_version": "1.23.0",
  "source": "health_connect",
  "sequence": 1842,
  "daily_totals": [
    {
      "date": "2026-10-04",
      "steps": 1204,
      "distance_meters": 911.6,
      "active_calories": 58.2,
      "total_calories": 702.9
    }
  ],
  "steps": [
    {
      "uuid": "eb52b2c4-e3f7-49f3-8f92-34ca86640305",
      "source": "com.fitbit.FitbitMobile",
      "count": 412,
      "start_time": "2026-10-04T06:00:00Z",
      "end_time": "2026-10-04T07:00:00Z"
    }
  ],
  "heart_rate": [
    {
      "uuid": "708a76cb-45d3-45ea-9f8b-26d6d55d2692#1791097080000",
      "source": "com.fitbit.FitbitMobile",
      "bpm": 61,
      "time": "2026-10-04T06:58:00Z"
    }
  ]
}

De source van een meting is de pakketnaam van de app die de meting schreef. De payload-referentie beschrijft elk type, en met een JSON Schema valideer je wat er binnenkomt.

De handtekening controleren

Met een geheim ingesteld draagt elk verzoek X-Signature: sha256=<hex>, de HMAC-SHA256 van de ruwe body. Gebruik het geheim als UTF-8-tekst, zonder het te decoderen, en bereken de HMAC over de bytes zoals ze binnenkwamen, voordat je ze parset. Vergelijk in constante tijd en antwoord met 401 als de handtekening niet klopt:

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

Vraagt je reverse proxy om een clientcertificaat, installeer dat dan in de instellingen van Android en kies het onder Meer > Geavanceerd > Clientcertificaat (mTLS).

Nieuwe pogingen, wachtrij en verwijderingen

  • Nieuwe pogingen. Elke 2xx telt als afgeleverd. Bij een time-out, netwerkfout, 408, 429 of 5xx doet de app 3 pogingen. Een 400, 413 of 422 wordt niet opnieuw geprobeerd: de app biedt die payload een week lang bij elke sync opnieuw aan en laat hem daarna vallen, terwijl latere payloads gewoon de deur uit gaan. De app wacht hooguit 10 seconden, dus antwoord eerst en sla daarna op.
  • Wachtrij. Een mislukte payload blijft op de telefoon en gaat bij de volgende sync als eerste weg. De wachtrij bevat maximaal 700 Health Connect-payloads, een week aan syncs om de 15 minuten. Na een 401 of 404 wachten latere payloads tot je de instellingen hebt hersteld en komen ze daarna op volgorde binnen.
  • Dubbele en late payloads. Een meting kan opnieuw binnenkomen na een nieuwe poging of in een backfill, waarmee de app je oude data alsnog verstuurt. Sla metingen dus op met uuid als sleutel. Een payload die in de wachtrij stond, of een die je ontvanger weigerde en later opnieuw krijgt, kan na een nieuwere binnenkomen en bevat toch metingen die geen latere payload herhaalt: verwerk ook die metingen. Gebruik sequence, dat alleen oploopt, uitsluitend om conflicten te beslechten: een meting die in deleted_records stond van een payload met een hoger nummer blijft verwijderd, en de daily_totals voor een datum komen uit de payload met het hoogste nummer waarin die datum zat.
  • Verwijderingen. Een meting die in Health Connect is verwijderd, staat in deleted_records van de volgende payload, met type en uuid. Het bijhouden begint zodra de app een type voor het eerst synchroniseert, en een type waarvoor de telefoon bij een sync niet kan instaan staat in deletions_unavailable. Trek die recht met een backfill.

Ontvangers die werken

  • De Life Dashboard-stack. Gepubliceerde images voor een ontvanger die X-Signature controleert, Postgres en Grafana met zes dashboards, te installeren vanuit één compose-bestand of met een Helm-chart. Scan de QR-code met de koppelcode in de app, of laat de app wijzen naar http://<host>:8080/webhook/<label>. Zie de Life Dashboard-stack.
  • n8n. Een Webhook-node met Raw Body aan, een controle van de handtekening en een Respond to Webhook-node die 204 of 401 antwoordt. In Health Connect naar n8n staat de hele workflow, en in de payload-referentie de stappen met een Crypto-node.
  • 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.
  • InfluxDB of iets anders. Er is geen kant-en-klare ontvanger voor InfluxDB, dus schrijf een klein script. De payload-referentie heeft een ontvanger in Python en een in Node.js om mee te beginnen.

Opslaan in Postgres

Wat de POST ook ontvangt, n8n of een script, het opslagpatroon is hetzelfde:

  • Upsert elke meting op zijn payload-sleutel en uuid, in een text-kolom. Metingen van hartslag en huidtemperatuur hebben een # en een tijd achter het ID van het record, dus het is geen Postgres-uuid.
  • Bewaar daily_totals als één rij per datum, die alleen wordt vervangen door een payload met een hogere sequence: het totaal van vandaag loopt nog op.
  • Verwijder wat deleted_records noemt, op type en uuid. Verwijder voor een hartslag- of huidtemperatuurrecord elke meting waarvan de uuid begint met die uuid en een #.

De ontvanger van de Life Dashboard-stack doet alle drie, als je het liever niet zelf bouwt, en geeft het resultaat terug via een alleen-lezen API. Staat de data eenmaal in Postgres, dan kan een model dat jij kiest die lezen via een alleen-lezen MCP-server: Health Connect-data via MCP behandelt de eigen server van de stack en een server voor je eigen Postgres.

De iPhone-app stuurt dezelfde payload

Life Dashboard voor iPhone post Apple Health-data met dezelfde sleutels, eenheden en handtekening, en met "source": "healthkit_ios", zodat één ontvanger beide telefoons aankan. De app stuurt dezelfde sequence-teller, en zijn HRV is SDNN waar Android RMSSD stuurt, dus houd die twee uit elkaar. 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. Zie hoe je hem krijgt.

Beperkingen

  • Bij meerdere URL's telt een payload als afgeleverd zodra één ervan hem accepteert, en de andere krijgen hem niet opnieuw. Het tabblad Logs toont elk resultaat.
  • Voor data van meer dan 30 dagen voordat je de app voor het eerst toegang gaf, is de geschiedenistoestemming van Health Connect nodig. De backfill-pagina vraagt daarom.

Life Dashboard

Installeer de app, laat hem naar je URL sturen en tik op Test versturen. In de payload-referentie staan elk veld en een ontvanger in Python en Node.js.

Ontdek het op Google Play

€ 4,99 eenmalig in Google Play: de makkelijke weg, met automatische updates, en je steunt er de ontwikkeling mee.

Of gratis, dezelfde app met dezelfde ondertekeningssleutel: APK op GitHub · Obtainium · F‑Droid

Download in de App Store

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

Zelf bouwen met Xcode

Download de Android-app Payload-referentie

De open-source apps die deze gids gebruikt, voor Android en iPhone. Geen account en geen cloud. Meer over Android en iPhone.

Veelgestelde vragen

Kan ik in plaats daarvan de Google Health API gebruiken?

Voor data in je Google-account, zoals die van Fitbit en Pixel Watch, biedt Google in zijn cloud de Google Health API aan, waarvoor je een Google Cloud-project en een OAuth-client nodig hebt. Health Connect zelf heeft geen web-API. De Life Dashboard-app leest het uit op de telefoon, dus data van Samsung Health, Garmin Connect, Oura en Withings komt in dezelfde payload binnen, en onderweg gaat er niets via een Google-account.

Kan ik een echte payload zien voordat ik een ontvanger schrijf?

Ja. Voorbeeld van payload onder Wat versturen op het tabblad Gezondheid laat zien wat de volgende sync zou versturen, en met Meer > Data exporteren deel je dat als CSV of JSON.

Stuurt de app ook schermtijd?

Ja, als aparte payload met "source": "screen_time": minuten per app per dag over de laatste 7 dagen. Zie schermtijd per app.

Hoe voorkom ik dat stappen dubbel worden geteld?

Gebruik daily_totals voor stappen, afstand en calorieën. Als je losse metingen optelt, telt een wandeling één keer mee per apparaat dat die wandeling heeft geregistreerd.

Is er een CSV-export?

Ja. Met Meer > Data exporteren op het tabblad Gezondheid deel je wat de volgende sync zou versturen als CSV of JSON. Naar je server verlaat gezondheidsdata de app als JSON, en je ontvanger slaat die op in elk formaat dat hij wil.