Synchroniser les données Apple Health vers 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 applications ne sont pas autorisées à accéder aux données de santé lorsque l'iPhone est verrouillé. Les automatisations ne s'exécuteront que pendant les périodes où votre appareil est déverrouillé. Cela peut affecter la fraîcheur des données. Consultez les instructions pour la synchronisation manuelle pour maintenir les données à jour.

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

  • L'Actualisation en arrière-plan est désactivée pour l'application
  • L'appareil est en mode Économie d'énergie
  • L'appareil est resté inactif pendant de longues périodes
  • Les ressources système sont limitées
  • Plusieurs applications se disputent le temps d'exécution en arrière-plan

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

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

Lors de l'utilisation du format JSON, activez Requêtes par lots pour envoyer des données par lots sur plusieurs requêtes au lieu d'une seule charge utile.

• Activé - Répartit les données sur plusieurs requêtes pour éviter des charges utiles excessivement grandes
• Désactivé - Envoie toutes les données en une seule requête

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

Tests manuels

1. Appuyez sur "Exportation manuelle" dans l'écran de configuration de l'automatisation
2. Sélectionnez une plage de dates
3. Appuyez sur "Exporter" pour envoyer une requête de test
4. Vérifiez votre endpoint pour confirmer que les données ont été reçues

Consultation des journaux d'activité

1. Appuyez sur "Voir les journaux d'activité" dans l'écran de configuration de l'automatisation
2. Consultez les exécutions récentes de l'automatisation
3. Vérifiez s'il y a des erreurs ou des avertissements
4. Vérifiez les horodatages des requêtes et le statut de la réponse

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. 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

2. 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é

3. 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é