Pourquoi il faut une application sur l’iPhone
Apple Santé n’a pas d’API web. Les données vivent sur l’iPhone, et les applications les lisent par HealthKit d’Apple : quelque chose sur l’iPhone doit donc les lire et les transmettre. L’application Life Dashboard s’en charge et envoie directement aux URL que vous saisissez. Il n’y a ni compte ni serveur Life Dashboard sur le trajet, et l’application n’a ni mesure d’audience, ni rapport de plantage, ni publicité. Le guide Une API web pour Santé Connect ou Apple Santé en dit plus.
Ce qu’il vous faut
- Un iPhone sous iOS 17 ou plus récent, et Life Dashboard pour iPhone. 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.
- Un serveur qui accepte un POST JSON. Utilisez
https://. iOS n’autorise le simplehttp://que vers une adresse IP, un nom en.localou un nom sans point, ce qui est prévu pour votre propre réseau.
La mise en place
- Pendant la configuration de l’application, saisissez votre URL dans URL de webhook. Plus tard, touchez Ajouter une destination dans l’onglet Santé, saisissez-la et touchez Ajouter un webhook. Vous pouvez en ajouter plusieurs ; une synchronisation compte comme livrée dès que l’une d’elles l’accepte.
- Facultatif : touchez la destination dans l’onglet Santé. Sous En-têtes personnalisés, touchez Ajouter un en-tête pour un en-tête
Authorizationou une clé d’API. Saisissez un Secret de signature HMAC que votre serveur connaît aussi, ou touchez Générer puis Copier le secret. Touchez ensuite Enregistrer. Chaque adresse a son propre secret et ses propres en-têtes. - Touchez Ping de test pendant la configuration, ou Envoyer un test sur la fiche de la destination. Cela envoie un petit payload avec
"test": trueet sans enregistrements, avec ce qui est enregistré. Si votre serveur est chez vous, autorisez Réseau local quand iOS le demande. - Sous Données à envoyer, activez vos types et autorisez l’accès à Santé. Aperçu du payload, au même endroit, montre les 7 derniers jours tels que le payload se présenterait, et Synchroniser maintenant, dans l’onglet Santé, envoie les nouveautés. La première synchronisation d’un type envoie ses 7 derniers jours.
- Pour les données plus anciennes, touchez Envoyer l’historique sous Données à envoyer et choisissez jusqu’où remonter, de 30 jours à Tout l’historique.

À quoi ressemble le POST
Chaque requête est un POST JSON. Un payload abrégé, tiré de la page du payload iOS :
{
"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, au premier niveau, vauthealthkit_ios, là où l’application Android indiquehealth_connect.timezoneest le fuseau horaire de l’iPhone au moment où le payload a été construit. Toutes les heures du payload sont en UTC, et c’est dans ce fuseau quedaily_totalsdécoupe ses jours : un récepteur connaît ainsi le jour local après un changement d’heure ou un voyage. Tous les payloads le contiennent depuis la version 1.9.0.sequenceaugmente de un à chaque payload que l’iPhone construit, et une nouvelle tentative garde le numéro d’origine.- Chaque enregistrement a un
uuid, celui de l’échantillon dans Apple Santé, qui reste le même pendant toute la vie de l’enregistrement, et un champsource: le nom qu’Apple Santé donne à l’application ou à l’appareil qui l’a écrit. Pour les données que l’iPhone ou la montre enregistrent eux-mêmes, c’est le nom de l’appareil, qui contient souvent le nom de son propriétaire. daily_totalscontient les pas, la distance et les calories par jour local, pour aujourd’hui et les deux jours précédents, calculés avec les statistiques d’Apple Santé. Une marche enregistrée à la fois par l’iPhone et par la montre n’y compte qu’une fois ; additionner les enregistrements bruts la compte deux fois.
Les clés, les champs et les unités sont ceux de l’application Android. La référence du payload de l’application Android documente chaque type, et son schéma JSON couvre les deux applications. Le guide Les types de données d’Apple Santé énumère ce qu’un iPhone envoie, clé par clé.
Vérifier la signature
Avec un secret défini, chaque POST porte X-Signature: sha256=<hex>, le HMAC-SHA256 du corps brut de la requête avec votre secret comme clé. C’est le schéma de l’application Android : une seule vérification couvre donc les deux téléphones. Calculez-le 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. En 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));
}
En Python :
expected = "sha256=" + hmac.new(SECRET, body, hashlib.sha256).hexdigest()
valid = hmac.compare_digest(expected.encode(), presented.encode())
Pour un serveur placé derrière un reverse proxy qui exige un certificat client, importez-le sous forme de fichier .p12 sous Plus > Avancé. Il reste dans le trousseau de l’iPhone, et chaque webhook dont le serveur demande un certificat le reçoit, y compris en arrière-plan.
Les nouvelles tentatives et la file
- Nouvelles tentatives. Toute réponse 2xx compte comme une livraison. Une erreur réseau, un délai dépassé, un 408, un 429 ou un 5xx sont tentés jusqu’à 3 fois en tout, à 1 puis 2 secondes d’écart. Les autres erreurs, comme un 401 ou un 404, échouent tout de suite. Une tentative abandonne dès que la connexion reste immobile 10 secondes : répondez donc d’abord et stockez ensuite.
- La file. Chaque payload est mis en file sur l’iPhone avant d’être envoyé : une synchronisation qu’iOS interrompt à mi-chemin ne perd donc rien. Un payload non livré repart au retour du réseau, à la synchronisation suivante ou avec Réessayer maintenant, le plus ancien en premier, vers les URL et avec les en-têtes configurés à ce moment-là. La file s’arrête au premier payload qui échoue : les autres gardent ainsi leur ordre.
- Payloads refusés. Un payload que votre serveur refuse avec un 400, un 413 ou un 422 ne bloque pas les suivants. Il reste en file et est proposé de nouveau une fois par jour. Les payloads mis en file après lui peuvent alors arriver avant : utilisez
sequencepour rétablir l’ordre. - Payloads anciens et abandonnés. Un payload de plus de 7 jours est abandonné quand votre serveur répond par une erreur à sa livraison suivante, jamais pendant que l’iPhone est hors ligne. La file contient jusqu’à 700 payloads ; au-delà, le plus ancien disparaît. Chaque payload abandonné donne une ligne dans l’onglet Journaux et une notification.
- Les redirections ne sont suivies que sur le même hôte. Une redirection vers un autre hôte, comme une page de connexion placée devant votre serveur, compte comme un envoi en échec, et le journal nomme l’hôte vers lequel elle pointait.

Les enregistrements supprimés
Un enregistrement supprimé dans Apple Santé ne laisse rien à lire pour une synchronisation : l’application suit donc le registre des suppressions d’Apple Santé et nomme ce qui a disparu dans le payload suivant, avec la clé sous laquelle l’enregistrement était arrivé et l’uuid avec lequel il avait été livré :
"deleted_records": [
{ "type": "nutrition", "uuid": "84E37E8A-1C2D-4E5F-8A9B-0C1D2E3F4A5B" }
]
- Quand une suppression est le seul changement, la synchronisation envoie un payload avec
deleted_recordset sans enregistrements. - Apple Santé ne modifie jamais un enregistrement sur place. Une application qui en modifie un le supprime et en enregistre un nouveau sous un nouvel
uuid: une modification arrive donc sous la forme d’une suppression et d’un nouvel enregistrement. - La suppression d’un sommeil nomme une phase, pas la nuit. Retirez cette phase, ou remplacez les nuits que couvre un payload plus récent.
deletions_unavailableénumère les clés qu’un payload ne peut pas garantir, par exemple quand Apple Santé n’a pas répondu à temps ou qu’un type n’a pas été lu depuis plus de 7 jours. Réconciliez-les avec un backfill, le rattrapage de l’historique.
Quand l’application envoie
Sous Quand envoyer, réglez un intervalle de 15 minutes ou plus, 60 par défaut, ou des heures fixes dans la journée, les jours de votre choix, avec des heures de silence. iOS décide du moment où une application s’exécute en arrière-plan : une heure fixe signifie donc « pas avant ». Apple Santé réveille aussi l’application quand un type activé a de nouvelles données, au plus aussi souvent qu’Apple le permet pour ce type. L’actualisation en arrière-plan doit être activée pour l’application ; le mode Économie d’énergie la désactive.
Pour une synchronisation à une minute précise, créez dans Raccourcis une automatisation qui lance Synchroniser les données de santé à cette heure. La même action fonctionne à l’arrivée à la maison, à la voix avec Siri, depuis le widget de l’écran d’accueil et depuis une commande du Centre de contrôle sur iOS 18 et plus récent. Elle envoie ce qui est en file et ce qui est nouveau.
iOS chiffre Apple Santé tant que l’iPhone est verrouillé : une synchronisation qui démarre à ce moment-là attend donc le déverrouillage.

Le backfill
Envoyer l’historique, sous Données à envoyer, envoie la durée que vous choisissez, de 30 jours à tout l’historique, par fenêtres de 3 jours, les plus anciennes en premier, avec les champs backfill, window_start, window_end et window_complete. Les enregistrements sont ceux qu’envoie une synchronisation, uuid compris : le chevauchement se dédoublonne donc. window_complete vaut toujours false depuis un iPhone, car Apple Santé n’indique pas à une application quels types elle n’a pas le droit de lire. Les payloads de backfill ne vont que vers les webhooks, jamais vers MQTT ni dans la file.
Des récepteurs qui fonctionnent
- La stack Life Dashboard. Un récepteur qui vérifie
X-Signature, Postgres et des tableaux de bord Grafana, à partir d’un seul fichier compose. Scannez son QR code d’association dans l’application. Voir la stack Life Dashboard. - n8n. Un nœud Webhook avec Raw Body activé, une vérification de la signature dans un nœud Code, et un 204. Le guide Apple Santé vers n8n présente le workflow.
- 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.
- Un script à vous. La référence du payload Android propose des exemples de récepteurs en Python et en Node.js.
Stocker les données
- Faites un upsert de chaque enregistrement sur sa clé de payload et son
uuid. Un enregistrement peut arriver deux fois : un backfill renvoie sa période, et un envoi interrompu par iOS repart de la file. Un même échantillon d’énergie active compte à la fois dansactive_calorieset danstotal_calories: utilisez donc les deux comme clé. - Gardez
daily_totalsà raison d’une ligne par date, issue du payload dont lasequenceest la plus élevée parmi ceux qui contenaient cette date. - L’
uuidd’une nuit de sommeil vient de sa première phase : il reste donc le même pendant que la nuit s’allonge. Remplacez la nuit quand elle revient plus longue. - Supprimez ce que
deleted_recordsnomme, partypeetuuid, et ignorez unuuidque vous n’avez pas.
En quoi un payload d’iPhone diffère de celui d’Android
- La variabilité de la fréquence cardiaque est le SDNN, la mesure qu’Apple Santé enregistre. Android envoie le RMSSD sous la même clé ; ce n’est pas le même chiffre.
- Le
typed’un entraînement est un nom commerunningouhiit; Android envoie un numéro sous forme de chaîne. - Les phases de sommeil comprennent
in_bed, le temps passé au lit autour des phases, que seul un iPhone envoie. - Il n’y a ni payload de temps d’écran ni bloc
_diagnostics.
Un récepteur écrit pour Android fonctionne sans modification, à condition de traiter ces éléments comme facultatifs. La page du payload iOS énumère chaque différence.
Life Dashboard pour iPhone
Installez l’application, ajoutez votre URL et touchez Ping de test. La page du payload iOS liste tout ce qu’un iPhone envoie.
Obtenir l’application iPhone Référence du payload iOS
L’application iPhone open source utilisée dans ce guide. Sans compte, et les données ne vont que là où vous les envoyez. En savoir plus sur l’application.
Questions fréquentes
Puis-je exporter Apple Santé automatiquement, sans ouvrir l’application ?
Oui. Une fois configurée, l’application synchronise en arrière-plan selon votre planification, et Apple Santé la réveille quand il y a de nouvelles données. L’iPhone doit être déverrouillé pour qu’une synchronisation puisse lire Apple Santé, et iOS choisit le moment exact. Pour une minute fixe, utilisez une automatisation Raccourcis avec Synchroniser les données de santé.
Puis-je voir le JSON avant d’écrire un récepteur ?
Oui. Aperçu du payload, sous Données à envoyer, montre les 7 derniers jours sous forme de payload, Copier le JSON le place dans le presse-papiers, et Partager le transmet sous forme de fichier .json. Exporter les données, sous Plus, enregistre la même chose avec Exporter en JSON, ou avec Exporter en CSV à raison d’une ligne par enregistrement.
Comment éviter de compter les pas deux fois ?
Utilisez daily_totals pour les pas, la distance et les calories. Ils sont comptés comme l’app Santé les compte : un iPhone et une montre qui ont tous deux enregistré une marche ne la comptent qu’une fois.
Le même récepteur fonctionne-t-il pour un téléphone Android ?
Oui. Les deux applications envoient les mêmes clés, les mêmes unités et la même signature. Distinguez-les par le champ source de premier niveau : healthkit_ios ou health_connect. Le guide Santé Connect vers un webhook traite du côté Android.
L’application envoie-t-elle quoi que ce soit au développeur ?
Non. L’application n’a ni mesure d’audience, ni rapport de plantage, ni publicité, et il n’y a aucun serveur Life Dashboard. Les données ne vont qu’aux URL, au broker ou au Home Assistant que vous configurez.