HealthyApps Help Center

Synchroniser les données Apple Health vers REST API

Envoyer des données de santé à un endpoint REST API.

Last updated: June 9, 2026

Sur cette page

Guide d’automatisation REST API

Les automatisations REST API vous permettent d'exporter automatiquement vos données de santé vers tout service web qui accepte les requêtes HTTP POST. C'est idéal pour intégrer avec des backends personnalisés, des APIs tierces ou des webhooks.

Vue d'ensemble

Les automatisations REST API envoient vos données de santé à un endpoint URL spécifié en utilisant des requêtes HTTP POST. L'automatisation peut envoyer des données au format JSON ou CSV, avec des en-têtes configurables pour l'authentification et les métadonnées personnalisées.

Cas d'usage :

  • Intégration avec des services backend personnalisés
  • Envoi de données vers des webhooks
  • Synchronisation avec des APIs tierces
  • Création de tableaux de bord personnalisés ou de plateformes d'analyse

Fonctionnalités principales :

  • Prend en charge les formats JSON et CSV
  • En-têtes HTTP personnalisés pour l'authentification
  • Délai d'attente de requête configurable
  • Exportation manuelle des données historiques

Limitations :

  • Accès aux données de santé : Les apps ne peuvent pas accéder aux données de santé lorsque l’iPhone est verrouillé. Les automatisations ne s’exécutent que lorsque l’appareil est déverrouillé. C’est une limitation imposée par Apple, impossible à contourner. En savoir plus

  • Traitement en arrière-plan : iOS limite le traitement en arrière-plan pour préserver la batterie. Les automatisations dépendent de l’actualisation en arrière-plan de l’app et peuvent ne pas s’exécuter immédiatement si :

    • L’actualisation en arrière-plan est désactivée pour l’app
    • L’appareil est en mode Économie d’énergie
    • L’appareil est resté inactif longtemps
    • Les ressources système sont contraintes
    • Plusieurs apps se disputent le temps d’exécution en arrière-plan

Performances

Gardez à l’esprit qu’iOS est optimisé pour des tâches de courte durée sur un appareil mobile avec des contraintes de performance très strictes. Les tâches en arrière-plan doivent généralement se terminer en 30 secondes et sont limitées en mémoire. Health Auto Export offre une grande flexibilité et personnalisation, ce qui demande de prendre le temps de comprendre comment certaines configurations affectent les performances de l’app et les résultats.

  • Configuration : Les automatisations qui produisent de grandes quantités de données peuvent amener le système à arrêter le processus et empêcher les automatisations de s’exécuter en arrière-plan. Les configurations suivantes peuvent produire de grandes quantités de données :
    • Automatisations configurées pour exporter toutes les métriques de santé.
      • Recommandation : ne sélectionnez que les métriques de santé qui ont des données enregistrées dans Apple Health et uniquement les données que vous prévoyez d’utiliser. Même les types de données vides ont un impact sur les performances. Vous pouvez aussi répartir les métriques sélectionnées sur plusieurs automatisations, ce qui facilite le travail du système.
    • Automatisations utilisant un regroupement temporel en secondes ou minutes, ou avec Résumer les données désactivé. De telles requêtes très fines peuvent être longues à exécuter et entrer en conflit avec les limitations du système.
      • Recommandation : même s’il peut sembler idéal d’avoir les données les plus détaillées possible, demandez-vous si ce niveau de détail est nécessaire pour chaque métrique ou type de données. Envisagez plusieurs automatisations avec des paramètres différents.
    • Lors de l’exportation d’entraînements en plein air (vélo, course, randonnée, etc.) avec données d’itinéraire, le GPS et les métriques de santé associées peuvent produire de grandes charges utiles.
  • Taille de la charge utile : Surtout avec l’exportation REST API, gardez à l’esprit que de grandes charges peuvent provoquer des erreurs serveur. Assurez-vous que votre backend peut gérer des charges pouvant atteindre plusieurs centaines de mégaoctets pour éviter les erreurs.
  • Fréquence de synchronisation : Ajoutez le widget Automatisations à l’écran d’accueil pour favoriser l’exécution réussie des automatisations en arrière-plan (voir Guide de configuration du widget Automatisations).

Prérequis

  • Un endpoint URL valide qui accepte les requêtes HTTP POST
  • Identifiants d'authentification (si requis par votre endpoint)
  • Connectivité réseau pour atteindre votre endpoint

Configuration de l'automatisation

Naviguez vers l'écran Exports automatisés depuis la navigation principale, puis appuyez sur "Nouvelle automatisation" et sélectionnez "REST API" comme Type d'automatisation.

Nom de l'automatisation

Entrez un nom descriptif pour votre automatisation (par exemple, "Mon API backend", "Intégration webhook").

Notifications

Configurez quand vous souhaitez recevoir des notifications :

  • Notifier lors de la mise à jour du cache - Recevez une notification lorsque les données en cache sont mises à jour
  • Notifier lors de l'exécution - Recevez une notification à chaque fois que l'automatisation s'exécute

Configuration de l'URL

Entrez l'URL complète où vous souhaitez envoyer vos données de santé. Il doit s'agir d'une URL complète incluant le protocole (http:// ou https://).

Exemples d'URL :

  • https://api.example.com/health-data
  • https://webhook.site/your-unique-id
  • http://localhost:3000/api/health

Note : L'URL doit être valide et accessible depuis votre appareil. Les URL invalides empêcheront l'automatisation de s'exécuter.

Délai d'attente de la requête

Sélectionnez un intervalle de délai d'attente pour les requêtes HTTP. Cela détermine combien de temps l'application attendra une réponse avant de considérer que la requête a échoué.

En-têtes HTTP

Ajoutez des en-têtes HTTP personnalisés pour l'authentification ou les métadonnées. Les cas d'usage courants incluent :

  • Clés API : X-API-Key: your-api-key
  • Tokens d'autorisation : Authorization: Bearer your-token
  • Remplacements de type de contenu : Content-Type: application/json

Pour ajouter des en-têtes :

  1. Appuyez sur "Ajouter des en-têtes"
  2. Entrez la clé de l'en-tête dans le champ de gauche
  3. Entrez la valeur de l'en-tête dans le champ de droite
  4. Répétez pour des en-têtes supplémentaires

Important : Chaque clé d'en-tête doit avoir une valeur correspondante. Les en-têtes vides seront ignorés.

Paramètres de type de données

Type de données

Sélectionnez le type de données de santé à exporter :

  • Métriques de santé - Pas, fréquence cardiaque, sommeil et autres mesures de santé
  • Entraînements - Activités d'exercice et de fitness
  • Symptômes - Symptômes et conditions de santé
  • ECG - Lectures d'électrocardiogramme
  • Notifications de fréquence cardiaque - Événements de fréquence cardiaque élevée/faible
  • État d'esprit - Entrées d'humeur et d'état mental (iOS 18.0+)
  • Suivi du cycle - Données de cycle menstruel et de santé reproductive
  • Médicaments - Journaux de médicaments et adhésion (iOS 26.0+)

Configuration des métriques de santé

Lorsque Métriques de santé est sélectionné :

Sélectionner les métriques de santé - Choisissez quelles métriques spécifiques inclure. Vous pouvez sélectionner toutes les métriques disponibles ou choisir des métriques spécifiques.

Astuce : Sélectionner uniquement les métriques dont vous avez besoin peut améliorer le temps de traitement et réduire la taille des données.

Sources préférées - Configurez quelles sources de données ont la priorité lorsque plusieurs sources fournissent la même métrique.

Configuration des entraînements

Lorsque Entraînements est sélectionné :

Inclure les données de route - Activez pour inclure les routes pour les entraînements qui ont des données de localisation.

Inclure les métriques d'entraînement - Activez pour inclure les métriques de santé collectées pendant les entraînements (fréquence cardiaque, calories, etc.).

Regroupement temporel (métriques d'entraînement) - Lors de l'utilisation de la Version d'export 2 et lorsque Inclure les métriques d'entraînement est activé :

  • Minutes - Regroupe les métriques d'entraînement par minute
  • Secondes - Regroupe les métriques d'entraînement par seconde

Paramètres d'export

Format d'export

Sélectionnez le format pour vos données exportées :

  • Format JSON - Fournit des structures de données détaillées avec des objets imbriqués. Idéal pour les APIs, les bases de données et les applications qui ont besoin de données structurées. Le format JSON inclut des informations plus détaillées pour les types de données complexes comme les phases de sommeil et les lectures AFib.

  • Format CSV - Fournit des données tabulaires qui peuvent être facilement importées dans des applications de tableur. Idéal pour l'analyse de données simple ou lorsque votre endpoint attend des données CSV.

Note : L'en-tête Content-Type est automatiquement défini sur application/json pour les exports JSON et multipart/form-data pour les exports CSV.

Version d'export

Sélectionnez une Version d'export. Le versioning permet de passer entre les versions mises à jour de l'export à votre propre rythme et minimise les changements qui cassent les flux de travail.

  • Version 1 - Format hérité, utilisez-le si vous avez des flux de travail existants qui dépendent de ce format
  • Version 2 - Format actuel avec des données d'entraînement améliorées et des options de métadonnées plus détaillées

Plage de dates

Sélectionnez quand les données doivent être exportées :

  • Par défaut - Synchronise les données pour la journée précédente complète plus les données jusqu'à la date et l'heure actuelles
  • Depuis la dernière synchronisation - À chaque synchronisation, exporte toutes les données depuis la dernière fois que l'export a été exécuté jusqu'à la date et l'heure actuelles
  • Aujourd'hui - Synchronise toutes les données pour la date actuelle jusqu'à l'heure actuelle
  • Hier - Synchronise toutes les données pour la journée précédente complète
  • 7 derniers jours - Synchronise les données pour les sept derniers jours complets

Résumer les données

Lors de l'utilisation du format JSON avec le type de données Métriques de santé, activez ou désactivez Résumer les données.

  • Activé - Fournit des résumés de données agrégées
  • Désactivé - Fournit des données désagrégées lorsque possible, montrant des points de données individuels

Note : Ce paramètre s'applique uniquement au format JSON avec Métriques de santé. Les données sont toujours agrégées lors de l'utilisation du format CSV ou lorsque plusieurs métriques sont sélectionnées.

Regroupement temporel

Lors de l'utilisation du format JSON avec Résumer les données activé, sélectionnez comment les données doivent être agrégées.

Note : Le format CSV agrège toujours les données. L'agrégation au niveau de la minute et de la seconde peut considérablement augmenter le temps de traitement et la taille des données.

Requêtes par lots et charges volumineuses

Avec le format JSON, activez Requêtes par lots pour envoyer les données en plusieurs requêtes HTTP au lieu d’une seule charge volumineuse.

  • ACTIVÉ — Répartit les données sur plusieurs requêtes. À utiliser si votre point de terminaison a des limites de taille, des délais sur de gros corps ou un traitement incrémental.
  • DÉSACTIVÉ — Envoie toutes les données en une seule requête. Convient aux petits exports et webhooks simples.

Quand activer le lot :

  • Nombreuses métriques de santé, longues plages de dates ou regroupement temporel fin (minutes/secondes)
  • Résumer les données est DÉSACTIVÉ et vous exportez des métriques désagrégées
  • Votre serveur renvoie des erreurs ou délais sur de gros corps POST

Remarques :

Cadence de synchronisation

Configurez la fréquence à laquelle l'automatisation doit télécharger les données :

Sélectionnez un nombre et un intervalle.

Tests et vérification

Vérification du format des données

L'application inclut automatiquement ces en-têtes dans chaque requête :

  • Content-Type - Défini en fonction du format d'export
  • automation-name - Le nom de votre automatisation
  • automation-id - Identifiant unique pour l'automatisation
  • automation-aggregation - Le regroupement temporel sélectionné
  • automation-period - La plage de dates sélectionnée
  • session-id - Identifiant unique pour chaque requête

Dépannage

Problèmes courants

Données non reçues à l'endpoint

  • Vérifiez que l'URL de l'endpoint est correcte
  • Vérifiez que votre endpoint accepte les requêtes POST
  • Examinez les en-têtes d'authentification
  • Vérifiez les journaux de l'endpoint pour les requêtes entrantes
  • Vérifiez la connectivité réseau

Conseils et meilleures pratiques

  1. Synchronisation automatique :

    • Chargez l’appareil et utilisez la duplication iPhone
      • Pendant la charge, iOS impose moins de restrictions de performances, ce qui permet une synchronisation plus fréquente
      • Avec la duplication iPhone, l’appareil se comporte comme s’il était déverrouillé. Health Auto Export peut ainsi accéder aux données de santé pour exécuter des actions automatisées

  2. Performance :

    • Utilisez un regroupement temporel approprié pour équilibrer le détail vs. la taille des données
    • Sélectionnez uniquement les métriques dont vous avez besoin

  3. Fiabilité :

    • Définissez des valeurs de délai d'attente appropriées en fonction du temps de réponse de votre endpoint
    • Surveillez régulièrement les journaux d'activité

  4. Format des données :

    • Utilisez JSON pour les données structurées et les APIs
    • Utilisez CSV pour l'analyse de données simple ou l'intégration avec des tableurs
    • Envisagez des requêtes par lots pour les grands ensembles de données ou le traitement séparé

Affichage des journaux d’activité

  1. Touchez Afficher les journaux d’activité dans l’écran de configuration de l’automatisation.
  2. Passez en revue les exécutions (regroupées, les plus récentes en premier) et développez les événements de chaque exécution.
  3. Distinguez les avertissements (p. ex. requête lente de données de santé) des erreurs (échecs HTTP, délais dépassés ou erreurs de lecture HealthKit)—voir Vue d’ensemble des automatisations — Journaux d’activité.
  4. Les envois REST réussis affichent souvent un résumé avec format, type de données, période d’export et plage de dates dans l’exécution.
  5. Partager (barre d’outils) exporte le ZIP de diagnostic complet des Journaux d’événements de l’app pour l’assistance (comme Réglages → Avancé).
  6. Effacer supprime uniquement l’historique d’activité de cette automatisation.