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
- 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.
- Het adres opent op een eigen pagina. Optioneel: voeg een
Authorization-header of API-sleutel toe onder Headers. - 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.
- 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.
- 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.

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
uuidals 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. Gebruiksequence, dat alleen oploopt, uitsluitend om conflicten te beslechten: een meting die indeleted_recordsstond van een payload met een hoger nummer blijft verwijderd, en dedaily_totalsvoor 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_recordsvan de volgende payload, mettypeenuuid. 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 indeletions_unavailable. Trek die recht met een backfill.
Ontvangers die werken
- De Life Dashboard-stack. Gepubliceerde images voor een ontvanger die
X-Signaturecontroleert, 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 naarhttp://<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 eentext-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_totalsals één rij per datum, die alleen wordt vervangen door een payload met een hogeresequence: het totaal van vandaag loopt nog op. - Verwijder wat
deleted_recordsnoemt, optypeenuuid. Verwijder voor een hartslag- of huidtemperatuurrecord elke meting waarvan deuuidbegint met dieuuiden 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.
€ 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 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.