Centre d'aide HealthyApps
Français
Centre d'aide
Site principal ↗

Rechercher dans l’aide

Automatisation par lien profond

Créez une automatisation d’API REST en ouvrant une URL sur votre iPhone ou iPad.

Dernière mise à jour: 31 octobre 2026

Sur cette page
Format d’URL
Référence des paramètres Référence des paramètres Réglages de baseIndicateurs de santéEntraînementsCadence et notifications
Authentification et encodage
Exemples Exemples Indicateurs sélectionnés, résumés par heureEntraînements avec itinéraires
DépannageDocumentation connexe

Créez une automatisation d’API REST en ouvrant une URL sur votre iPhone ou iPad. Les liens profonds ne configurent pas d’autres destinations.

Format d’URL

com.HealthExport://automation?url=https%3A%2F%2Fapi.example.com%2Fhealth&name=Daily%20Export

url est obligatoire. Fournissez un name descriptif ; s’il est omis, la valeur par défaut est Automation. Les noms de paramètre ne distinguent pas la casse. Encodez en URL les valeurs de paramètre qui contiennent des espaces ou des caractères réservés.

Ouvrez l’URL sur votre appareil, ou utilisez Ouvrir des URL dans Raccourcis. Examinez l’automatisation créée dans Health Auto Export avant de l’activer.

Référence des paramètres

Les booléens acceptent true/false, 1/0 ou yes/no. Définissez datatype avant ses options spécifiques aux données, et format avant aggregatedata, afin que les sélections ultérieures ne remplacent pas les réglages antérieurs.

Réglages de base

Paramètre Valeurs ou signification Par défaut
url URL du point de terminaison accessible depuis votre appareil Obligatoire
name Nom d’automatisation non vide Automation
enabled Activer les exécutions automatiques false
datatype Type de données listé ci-dessous healthMetrics
format json, csv, markdown ou md json
exportversion v1, v2, 1 ou 2 v2
period none, lastsync, today, yesterday, previous7days none
requesttimeout Secondes entières, 60–86400 60
headers Paires clé/valeur séparées par des virgules Aucun
batchrequests Booléen ; JSON uniquement false

Les types de données valides sont healthMetrics, workouts, symptoms, ecg, heartRateNotification, stateOfMind, cycleTracking et medications. État d’esprit nécessite iOS 18 ou ultérieur ; les exportations de médicaments nécessitent iOS 26 ou ultérieur.

Pour la signification des plages de dates, consultez Plage de dates. Tous les liens profonds créent des automatisations d’API REST ; il n’y a pas de paramètre exportDestination.

Indicateurs de santé

Paramètre Valeurs ou signification Par défaut
metrics Noms exacts d’indicateurs séparés par des virgules, comme Step Count,Heart Rate Tous les indicateurs disponibles
aggregatedata Booléen ; utilisez false pour des lectures individuelles lorsqu’elles sont prises en charge true
interval none, minutes, hours, days, weeks, months, years none
aggregatesleep Booléen qui contrôle le résumé du sommeil true

metrics, aggregatedata et interval s’appliquent aux indicateurs de santé. La sélection CSV active le résumé ; utilisez JSON pour des lectures individuelles. Indiquez le résumé souhaité de façon explicite lors de la génération des liens.

Entraînements

Paramètre Valeurs ou signification Par défaut lorsque datatype=workouts
includeroutes Booléen true
includeworkoutmetadata Booléen true
workoutsmetadatainterval minutes ou seconds ; Version 2 minutes
workouttypes Identifiants de type d’entraînement Apple non signés, séparés par des virgules Tous les types

N’incluez pas d’options d’agrégation d’indicateurs de santé dans un lien d’entraînement.

Cadence et notifications

Paramètre Valeurs ou signification Par défaut
syncinterval minutes, hours, days, weeks minutes
syncquantity Nombre entier positif d’intervalles 5
notifyonupdate Booléen ; notifier après la préparation des données true
notifywhenrun Booléen ; notifier après une action réussie à la destination true

La cadence reste soumise aux limites d’arrière-plan et de données de santé ; ce n’est pas un horaire exact.

Authentification et encodage

La valeur de headers consiste en des clés et valeurs alternées :

headers=Authorization,Bearer%20YOUR_TOKEN,X-API-Key,YOUR_KEY

Chaque clé nécessite une valeur. Les virgules séparent les paires, donc évitez les valeurs d’en-tête contenant des virgules dans ce format de lien. Encodez les espaces comme %20, les signes plus comme %2B et les esperluettes comme %26. Encodez l’URL complète du point de terminaison lorsqu’elle a ses propres paramètres de requête.

Exemples

Indicateurs sélectionnés, résumés par heure

com.HealthExport://automation?url=https%3A%2F%2Fapi.example.com%2Fmetrics&name=Steps%20and%20Heart%20Rate&datatype=healthMetrics&format=json&metrics=Step%20Count,Heart%20Rate&aggregatedata=true&interval=hours

Entraînements avec itinéraires

com.HealthExport://automation?url=https%3A%2F%2Fapi.example.com%2Fworkouts&name=Workout%20Export&datatype=workouts&format=json&includeroutes=true&includeworkoutmetadata=true&exportversion=v2&workoutsmetadatainterval=minutes

Les deux exemples laissent les exécutions automatiques désactivées jusqu’à ce que vous examiniez et activiez l’automatisation.

Dépannage

  • Erreur d’URL ou de paramètre : Commencez par l’URL minimale, vérifiez l’orthographe et l’encodage, puis ajoutez les options une par une.
  • Indicateur non valide : Utilisez le nom exact de l’indicateur, y compris les espaces et la casse.
  • Erreur d’agrégation : Utilisez les options d’indicateurs de santé uniquement avec datatype=healthMetrics.
  • Erreur de réglages d’entraînement : Utilisez les options d’entraînement avec datatype=workouts ; le groupement en secondes nécessite la Version 2.
  • Erreur de lots : Définissez format=json ou désactivez batchrequests.
  • Cadence/délai d’attente non valides : Utilisez les intervalles pris en charge, une quantité positive et un délai d’attente de 60 à 86400 secondes.
  • URL trop longue : Réduisez la liste d’indicateurs/en-têtes ou configurez le reste dans l’app.

Après la création, utilisez API REST — Exporter des données historiques ou manquées pour téléverser une plage sélectionnée ou vérifier la configuration.

Documentation connexe