Synchroniser les données Apple Santé avec MQTT
Publiez des données de santé sur un courtier MQTT.
Dernière mise à jour: 31 octobre 2026
Sur cette page
Réglages d’exportation
Réglages d’exportation Version d’exportationPlage de datesRésumer les données et groupement temporelPubliez des exportations de santé au format JSON sur un sujet de votre courtier MQTT.
Important — limitations des automatisations : Votre appareil doit être déverrouillé pour lire les données de santé, et iOS ne garantit pas les exécutions en arrière-plan à la fréquence que vous choisissez. Consultez les limitations des automatisations avant de vous fier aux exportations automatiques.
Ouvrir l’automatisation
Ouvrez Exporter → Automatisé sur iPhone, ou Automatisations dans la barre latérale de l’iPad. Sélectionnez Nouvelle automatisation, ou ouvrez une automatisation existante pour la modifier.
Nom, état et notifications
Saisissez un nom qui identifie cette automatisation. Activé autorise les exécutions automatiques ; laissez-le désactivé jusqu’à ce que vous soyez prêt.
Choisissez les notifications d’exécution que vous souhaitez :
- Notifier lors de la mise à jour du cache signale que les données d’exportation ont été préparées.
- Notifier à l’exécution signale une publication réussie sur le courtier.
Autorisez les notifications lorsque cela vous est demandé. Ces notifications signalent l’activité ; elles ne planifient pas une exécution.
Configurer la connexion
- Choisissez MQTT comme Type d’automatisation.
- Saisissez le nom d’hôte ou l’adresse IP du courtier et le port. Le port par défaut est 1883.
- Saisissez le Sujet, par exemple
health/metrics. - Définissez un ID client unique pour chaque automatisation et saisissez un nom d’utilisateur et un mot de passe si le courtier l’exige.
Le courtier doit être accessible depuis votre appareil. Les abonnés doivent utiliser le sujet exact, y compris la casse. Réutiliser un ID client peut faire se remplacer mutuellement les connexions du courtier.
Réglages du type de données
Sélectionnez un Type de données pour cette automatisation : Indicateurs de santé, Entraînements, Symptômes, ECG, Notifications de fréquence cardiaque, État d’esprit, Suivi du cycle ou Médicaments. État d’esprit nécessite iOS 18 ou ultérieur ; Médicaments nécessite iOS 26 ou ultérieur et un accès distinct aux médicaments.
Indicateurs de santé
Choisissez Indicateurs de santé, ouvrez Sélectionner les indicateurs de santé et sélectionnez les mesures dont vous avez besoin.
Pour limiter les lectures à certaines apps ou appareils, ouvrez Sources préférées, choisissez un indicateur et sélectionnez ses sources. Toutes autorise toutes les sources qui n’ont pas été exclues. Utilisez Sources exclues pour ignorer une source pour les indicateurs de santé de cette automatisation. Les exclusions priment ; une source non sélectionnée n’est pas substituée lorsqu’une source préférée n’a pas de données. Sélectionnez Enregistrer pour appliquer les choix de source ou Annuler pour les abandonner.
Entraînements
Choisissez Entraînements pour exporter les enregistrements d’entraînement. Inclure les données d’itinéraire ajoute les points d’itinéraire disponibles aux données JSON de l’entraînement. Cela ne crée pas de téléversements GPX séparés.
Pour la Version 2, activez Inclure les indicateurs d’entraînement pour ajouter des lectures comme la fréquence cardiaque, l’énergie active et les pas. Choisissez Minutes ou Secondes pour le Groupement temporel des indicateurs d’entraînement ; les secondes produisent plus de détail et des exportations plus volumineuses. La Version 1 inclut toujours les indicateurs d’entraînement.
Réglages d’exportation
MQTT publie uniquement du JSON. Les messages utilisent QoS 0 pour la publication au premier plan et QoS 1 pour la publication en arrière-plan. Les messages ne sont pas retenus.
Version d’exportation
Choisissez Version 2 pour la structure de données actuelle. Utilisez Version 1 lorsqu’un flux de travail existant dépend de l’ancien format.
Plage de dates
| Sélection | Données incluses |
|---|---|
| Par défaut | La veille et aujourd’hui jusqu’à l’heure d’exécution |
| Depuis la dernière synchronisation | Depuis la synchronisation précédente jusqu’à l’heure d’exécution |
| Aujourd’hui | Aujourd’hui jusqu’à l’heure d’exécution |
| Hier | La journée complète précédente |
| 7 jours précédents | Les sept journées complètes précédentes |
Résumer les données et groupement temporel
Pour JSON + Indicateurs de santé, activez Résumer les données pour combiner les lectures en groupes temporels, ou désactivez-le pour des lectures individuelles lorsqu’elles sont disponibles. Le résumé dépend de l’indicateur — par exemple, les pas sont totalisés et les lectures de poids sont moyennées. Les exportations CSV d’indicateurs de santé utilisent des données résumées.
Lorsque Groupement temporel est disponible, choisissez le niveau de détail à conserver. Les groupes horaires ou quotidiens produisent moins de lignes que les groupes par minute ou par seconde. Les choix disponibles dépendent de la plage de dates et du format. Le groupement temporel des entraînements se configure séparément sous Entraînements.
Planifier des rappels
Si vous souhaitez une invite pour déverrouiller et ouvrir l’app, activez Activer les rappels. Choisissez Toutes les heures, Tous les jours ou Jours sélectionnés, puis définissez la minute, l’heure et les jours le cas échéant. Autorisez l’accès aux notifications lorsque cela vous est demandé ; si l’accès est refusé, utilisez Ouvrir les réglages de notification.
Un rappel n’exécute pas l’automatisation et ne confirme pas une synchronisation réussie. Appuyez dessus pour ouvrir l’automatisation, ou utilisez Ouvrir et synchroniser sur la notification pour demander une exécution. L’automatisation doit être activée ; un rappel peut encore apparaître après une exécution en arrière-plan réussie. Les modifications de rappel s’appliquent lorsque vous enregistrez.
Fréquence de synchronisation et enregistrement
Choisissez un nombre et Minutes, Heures, Jours ou Semaines sous Fréquence de synchronisation — par exemple, toutes les 15 minutes. Il s’agit d’une cadence souhaitée en arrière-plan, pas d’un horaire garanti.
Votre appareil doit être déverrouillé lorsque les données de santé sont lues. Activez l’Actualisation en arrière-plan pour Health Auto Export et désactivez le mode Économie d’énergie pour les exécutions automatiques. iOS peut encore retarder les exécutions lorsque l’appareil a été inactif ou que les ressources système sont limitées.
Activez Activé lorsque vous êtes prêt pour les exécutions automatiques, puis sélectionnez Mettre à jour pour enregistrer l’automatisation. Vous pouvez téléverser immédiatement une plage de dates sélectionnée à l’aide des étapes ci-dessous.
Exporter des données historiques ou manquées
Utilisez Téléversement manuel lors de la première configuration de l’automatisation pour exporter des données historiques, ou plus tard pour couvrir les dates manquées par la synchronisation automatique. Vous pouvez aussi l’utiliser pour vérifier votre configuration.
- Connectez un abonné MQTT à votre courtier et abonnez-vous au sujet configuré.
- Dans Health Auto Export, ouvrez l’automatisation et sélectionnez Téléversement manuel sous Exporter les données existantes.
- Définissez les dates de Début et de Fin, puis sélectionnez Commencer l’exportation.
- Vérifiez le JSON reçu et ses dates.
La charge utile suit le format d’exportation JSON. Par exemple :
{
"data": {
"metrics": [
{
"name": "step_count",
"units": "count",
"data": [{"date": "2024-02-06 00:00:00 -0800", "qty": 8500}]
}
]
}
}
Dépannage
- Erreur de connexion : Vérifiez l’hôte, le port, l’accès réseau et les exigences de connexion du courtier.
- Erreur d’authentification : Vérifiez les identifiants et l’autorisation de publier sur le sujet.
- Aucun message : Confirmez que l’abonné utilise le même courtier et le sujet exact, et examinez les journaux d’activité.
- Message trop volumineux : Sélectionnez moins d’indicateurs, une plage plus courte ou un groupement temporel plus grossier.
Ouvrez l’automatisation et sélectionnez Voir les journaux d’activité pour examiner une exécution. Les avertissements signalent des problèmes potentiels comme une récupération de données lente ; les erreurs identifient les étapes échouées. Pour de l’aide à signaler un problème, voir Obtenir de l’aide.