Synchroniser les données Apple Santé avec API REST
Envoyez des données de santé vers un point de terminaison d’API REST.
Dernière mise à jour: 31 octobre 2026
Sur cette page
Réglages d’exportation
Réglages d’exportation Format d’exportationVersion d’exportationPlage de datesRésumer les données et groupement temporelEnvoyez des exportations de santé vers un point de terminaison qui accepte les requêtes HTTP POST.
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 un téléversement réussi vers votre point de terminaison.
Autorisez les notifications lorsque cela vous est demandé. Ces notifications signalent l’activité ; elles ne planifient pas une exécution.
Configurer le point de terminaison
- Choisissez API REST comme Type d’automatisation.
- Saisissez une URL accessible depuis votre iPhone ou iPad, par exemple
https://api.example.com/health-data. - Ajoutez l’authentification nécessaire dans En-têtes HTTP. Par exemple, utilisez
Authorizationcomme clé etBearer YOUR_TOKENcomme valeur. - Choisissez un Délai d’attente de la requête adapté à votre point de terminaison.
Chaque en-tête nécessite une clé et une valeur. Pour un serveur sur un autre appareil, utilisez son adresse réseau accessible plutôt que localhost.
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
Format d’exportation
- JSON conserve des données structurées pour les intégrations et l’analyse.
- CSV crée des fichiers tabulaires pour les tableurs.
- Markdown crée des titres et tableaux lisibles pour les notes et archives.
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.
Requêtes par lots et charges volumineuses
Pour API REST + JSON, activez Requêtes par lots pour envoyer les données en plusieurs requêtes. Utilisez-le lorsque votre point de terminaison refuse les corps volumineux ou que les grandes requêtes expirent. Le service récepteur doit traiter chaque requête séparément.
Les lots ne sont pas disponibles pour CSV ni Markdown. Ils réduisent la taille de chaque requête, mais pas la quantité de données de santé que l’appareil doit lire. Consultez Performances si la préparation est lente.
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.
En-têtes de la requête
L’app définit Content-Type pour le format choisi et inclut :
| En-tête | Signification |
|---|---|
automation-name |
Nom de l’automatisation |
automation-id |
Identifiant de l’automatisation |
automation-aggregation |
Groupement temporel sélectionné |
automation-period |
Plage de dates sélectionnée |
session-id |
Identifiant de la requête |
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.
- 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 la requête reçue sur votre point de terminaison, les en-têtes et le corps.
Dépannage
- Aucune requête reçue : Vérifiez l’URL, l’accessibilité du réseau et les journaux du serveur.
- Erreur d’authentification : Vérifiez la clé de l’en-tête, le jeton et les autorisations du point de terminaison.
- Charge refusée ou délai d’attente dépassé : Vérifiez les limites de taille du serveur, utilisez les lots pour JSON ou réduisez la taille de l’exportation.
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.