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
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=jsonou désactivezbatchrequests. - 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.