Pourquoi il faut une application sur le téléphone
Santé Connect n’a pas d’API web. C’est un espace de stockage sur le téléphone que les applications lisent par l’intermédiaire d’Android : quelque chose sur le téléphone doit donc le lire et le transmettre. L’application Life Dashboard s’en charge et envoie directement à votre URL, sans service cloud ni compte Google sur le trajet. Un seul payload réunit toutes les sources : ce que Samsung Health, Google Health (Fitbit et Pixel Watch), Garmin Connect, Oura et Withings écrivent dans Santé Connect, chaque enregistrement étant marqué du nom de l’application qui l’a écrit. La voie cloud de Google, l’API Google Health, demande un projet Google Cloud et un client OAuth, et ne voit que ce qui arrive dans votre compte Google.
Ce qu’il vous faut
- Android 9 ou plus récent avec Santé Connect, et une application qui y écrit, comme Samsung Health, Garmin Connect ou Google Health.
- Life Dashboard pour Android, sur Google Play pour 4,99 € en achat unique, ou gratuitement depuis GitHub Releases, Obtainium ou F‑Droid. Les options d’installation présentent toutes les voies.
- Un serveur qui accepte un POST JSON en HTTPS, avec une limite de corps d’au moins 10 Mo. Le HTTP non chiffré sur votre propre réseau demande d’activer Autoriser les webhooks en HTTP non chiffré sous Plus > Avancé.
Envoyer Santé Connect vers votre propre serveur
- Dans l’onglet Santé, touchez Ajouter une destination (ou Utiliser votre propre serveur si rien n’est encore configuré), collez votre URL sous URL de webhook et touchez Ajouter un webhook. L’onglet Temps d’écran a sa propre liste.
- L’adresse s’ouvre sur sa propre page. Facultatif : ajoutez un en-tête
Authorizationou une clé d’API sous En-têtes. - Sous Secret de signature HMAC (facultatif), touchez Générer et reportez la même valeur sur votre serveur. Chaque adresse a son propre secret : un second serveur a donc le sien.
- Touchez Enregistrer en haut, rouvrez la ligne de l’adresse dans l’onglet et touchez Envoyer un test pour vérifier que votre serveur accepte la requête.
- Accordez les autorisations Santé Connect et touchez Synchroniser maintenant. Envoyer l’historique, sous Données à envoyer, envoie de 30 jours à 5 ans, ou Tout l’historique : c’est le backfill, le rattrapage de l’historique.

À quoi ressemble le POST
Chaque requête est un POST avec Content-Type: application/json; charset=utf-8. Un payload de synchronisation avec les pas et la fréquence cardiaque, abrégé :
{
"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"
}
]
}
Le champ source d’un enregistrement est le nom de paquet de l’application qui l’a écrit. La référence du payload documente chaque type, et un schéma JSON vous permet de valider ce qui arrive.
Vérifier la signature
Avec un secret défini, chaque requête porte X-Signature: sha256=<hex>, le HMAC-SHA256 du corps brut. Utilisez le secret comme du texte UTF-8, sans le décoder, et calculez le HMAC sur les octets tels qu’ils sont arrivés, avant de les analyser. Comparez en temps constant et répondez 401 en cas de différence :
expected = "sha256=" + hmac.new(SECRET, body, hashlib.sha256).hexdigest()
valid = hmac.compare_digest(expected.encode(), presented.encode())
Pour un reverse proxy qui exige un certificat client, installez-le dans les paramètres d’Android et sélectionnez-le sous Plus > Avancé > Certificat client (mTLS).
Nouvelles tentatives, file d’attente et suppressions
- Nouvelles tentatives. Toute réponse 2xx compte comme une livraison. Un délai dépassé, une erreur réseau, un 408, un 429 ou un 5xx donnent lieu à 3 tentatives. Un 400, un 413 ou un 422 n’est pas retenté : l’application propose de nouveau ce payload à chaque synchronisation pendant une semaine, puis l’abandonne, tandis que les payloads suivants partent normalement. L’application attend au plus 10 secondes : répondez donc d’abord et stockez ensuite.
- File d’attente. Un payload en échec reste sur le téléphone et part en premier à la synchronisation suivante. La file contient jusqu’à 700 payloads Santé Connect, soit une semaine de synchronisations toutes les 15 minutes. Après un 401 ou un 404, les payloads suivants attendent que vous corrigiez la configuration, puis arrivent dans l’ordre.
- Doublons et payloads tardifs. Un enregistrement peut arriver de nouveau après une nouvelle tentative ou lors d’un backfill : stockez donc les enregistrements avec
uuidcomme clé. Un payload resté dans la file d’attente, ou un payload que votre récepteur a refusé et reçoit plus tard, peut arriver après un payload plus récent et contient toujours des enregistrements qu’aucun payload ultérieur ne répète : appliquez-les aussi. N’utilisezsequence, qui ne fait qu’augmenter, que pour trancher les conflits : un enregistrement qu’un payload de numéro supérieur a nommé dansdeleted_recordsreste supprimé, et lesdaily_totalsd’une date viennent du payload de numéro le plus élevé qui contenait cette date. - Suppressions. Un enregistrement supprimé dans Santé Connect est nommé dans le champ
deleted_recordsdu payload suivant, avec sontypeet sonuuid. Le suivi commence à la première synchronisation d’un type par l’application, et un type dont le téléphone ne peut pas répondre lors d’une synchronisation figure dansdeletions_unavailable; réconciliez ces types avec un backfill.
Des récepteurs qui fonctionnent
- La stack Life Dashboard. Des images publiées pour un récepteur qui vérifie
X-Signature, Postgres et Grafana avec six tableaux de bord, installés à partir d’un seul fichier compose ou avec un chart Helm. Scannez son QR code d’association dans l’application, ou dirigez l’application vershttp://<host>:8080/webhook/<label>. Voir la stack Life Dashboard. - n8n. Un nœud Webhook avec Raw Body activé, une vérification de la signature et un nœud Respond to Webhook qui répond 204 ou 401. Le guide Santé Connect vers n8n présente le workflow complet, et la référence du payload décrit les étapes avec un nœud Crypto.
- Node-RED. Un nœud http in avec Do not parse request body activé (Node-RED 4.1 ou plus récent) fournit les octets bruts pour le HMAC.
- Home Assistant. L’intégration Life Dashboard transforme le payload en capteurs et en statistiques à long terme.
- InfluxDB ou autre chose. Il n’existe pas de récepteur InfluxDB prêt à l’emploi : écrivez donc un petit script. La référence du payload propose un récepteur en Python et un autre en Node.js comme point de départ.
Stocker les données dans Postgres
Quel que soit ce qui reçoit le POST, n8n ou un script, le schéma de stockage est le même :
- Faites un upsert de chaque enregistrement sur sa clé de payload et son
uuid, dans une colonnetext. Les échantillons de fréquence cardiaque et de température cutanée portent un#et une heure après l’identifiant de l’enregistrement : ce n’est donc pas unuuidPostgres. - Gardez
daily_totalsà raison d’une ligne par date, remplacée uniquement par un payload dont lasequenceest supérieure : celui du jour est un total en cours. - Supprimez ce que
deleted_recordsnomme, partypeetuuid. Pour un enregistrement de fréquence cardiaque ou de température cutanée, supprimez chaque échantillon dont l’uuidcommence par cetuuidsuivi d’un#.
Le récepteur de la stack Life Dashboard fait les trois, si vous préférez ne pas le construire vous-même, et restitue le résultat par une API en lecture seule. Une fois les données dans Postgres, le modèle de votre choix peut les lire par un serveur MCP en lecture seule : le guide Les données de Santé Connect via MCP présente le serveur de la stack et un autre pour un Postgres à vous.
L’application iPhone envoie le même payload
Life Dashboard pour iPhone envoie les données d’Apple Santé avec les mêmes clés, les mêmes unités et la même signature, et "source": "healthkit_ios" : un seul récepteur accepte donc les deux téléphones. Elle envoie le même compteur sequence, et sa variabilité de la fréquence cardiaque est le SDNN là où Android envoie le RMSSD : gardez donc les deux séparés. Elle est sur l’App Store pour 6,99 € en achat unique (5,99 $US), sans abonnement. La compiler à partir du code source avec Xcode ne coûte rien de plus si vous avez déjà une adhésion à l’Apple Developer Program. Voir comment l’obtenir.
Les limites
- Avec plusieurs URL, un payload compte comme livré dès que l’une d’elles l’accepte, et les autres ne le reçoivent plus. L’onglet Journaux affiche chaque résultat.
- Les données antérieures de plus de 30 jours à votre première autorisation demandent l’autorisation d’historique de Santé Connect, que la page du backfill vous propose.
Life Dashboard
Installez l’application, indiquez-lui votre URL et touchez Envoyer un test. La référence du payload décrit chaque champ et propose un récepteur en Python et en Node.js.
4,99 € en achat unique sur Google Play : la voie simple, avec les mises à jour automatiques, et votre achat soutient le développement.
Ou gratuitement, la même application avec la même clé de signature : APK sur GitHub · Obtainium · F‑Droid
Obtenir l’application Android Référence du payload
Les applications open source utilisées dans ce guide, pour Android et iPhone. Sans compte, sans cloud. En savoir plus sur Android et iPhone.
Questions fréquentes
Puis-je utiliser l’API Google Health à la place ?
Pour les données de votre compte Google, comme celles de Fitbit et de la Pixel Watch, Google propose l’API Google Health dans son cloud, qui demande un projet Google Cloud et un client OAuth. Santé Connect lui-même n’a pas d’API web. L’application Life Dashboard le lit sur le téléphone : les données de Samsung Health, Garmin Connect, Oura et Withings arrivent donc dans le même payload, et rien ne transite par un compte Google.
Puis-je voir un vrai payload avant d’écrire un récepteur ?
Oui. Aperçu du payload, sous Données à envoyer dans l’onglet Santé, montre ce que la prochaine synchronisation enverrait, et Plus > Exporter les données le partage en CSV ou en JSON.
Envoie-t-elle aussi le temps d’écran ?
Oui, dans un payload distinct avec "source": "screen_time", les minutes par application et par jour des 7 derniers jours. Voir le temps d’écran par application.
Comment éviter de compter les pas deux fois ?
Utilisez daily_totals pour les pas, la distance et les calories. Additionner les enregistrements bruts compte une marche une fois par appareil qui l’a enregistrée.
Existe-t-il un export CSV ?
Oui. Plus > Exporter les données, dans l’onglet Santé, partage en CSV ou en JSON ce que la prochaine synchronisation enverrait. Vers votre serveur, les données de santé quittent l’application en JSON, et votre récepteur les stocke dans le format de son choix.