Automazione con deep link
Crea un’automazione API REST aprendo un URL sul tuo iPhone o iPad.
Ultimo aggiornamento: 31 ottobre 2026
In questa pagina
Crea un’automazione API REST aprendo un URL sul tuo iPhone o iPad. I deep link non configurano altre destinazioni.
Formato URL
com.HealthExport://automation?url=https%3A%2F%2Fapi.example.com%2Fhealth&name=Daily%20Export
url è obbligatorio. Fornisci un name descrittivo; se omesso, il valore predefinito è Automation. I nomi dei parametri non fanno distinzione tra maiuscole e minuscole. Codifica in URL i valori dei parametri che contengono spazi o caratteri riservati.
Apri l’URL sul tuo dispositivo, oppure usa Apri URL in Comandi Rapidi. Rivedi l’automazione creata in Health Auto Export prima di abilitarla.
Riferimento dei parametri
I booleani accettano true/false, 1/0 o yes/no. Imposta datatype prima delle sue opzioni specifiche dei dati, e format prima di aggregatedata, così che le selezioni successive non sostituiscano impostazioni precedenti.
Impostazioni di base
| Parametro | Valori o significato | Predefinito |
|---|---|---|
url |
URL dell’endpoint accessibile dal tuo dispositivo | Obbligatorio |
name |
Nome automazione non vuoto | Automation |
enabled |
Abilitare le esecuzioni automatiche | false |
datatype |
Tipo di dati elencato sotto | healthMetrics |
format |
json, csv, markdown o md |
json |
exportversion |
v1, v2, 1 o 2 |
v2 |
period |
none, lastsync, today, yesterday, previous7days |
none |
requesttimeout |
Secondi interi, 60–86400 | 60 |
headers |
Coppie chiave/valore separate da virgole | Nessuno |
batchrequests |
Booleano; solo JSON | false |
I tipi di dati validi sono healthMetrics, workouts, symptoms, ecg, heartRateNotification, stateOfMind, cycleTracking e medications. Stato d’animo richiede iOS 18 o successivo; le esportazioni dei farmaci richiedono iOS 26 o successivo.
Per il significato degli intervalli di date, consulta Intervallo di date. Tutti i deep link creano automazioni API REST; non c’è un parametro exportDestination.
Metriche di salute
| Parametro | Valori o significato | Predefinito |
|---|---|---|
metrics |
Nomi esatti delle metriche separati da virgole, come Step Count,Heart Rate |
Tutte le metriche disponibili |
aggregatedata |
Booleano; usa false per letture individuali quando supportato |
true |
interval |
none, minutes, hours, days, weeks, months, years |
none |
aggregatesleep |
Booleano che controlla il riepilogo del sonno | true |
metrics, aggregatedata e interval si applicano alle metriche di salute. La selezione CSV attiva il riepilogo; usa JSON per letture individuali. Indica il riepilogo desiderato in modo esplicito quando generi i link.
Allenamenti
| Parametro | Valori o significato | Predefinito quando datatype=workouts |
|---|---|---|
includeroutes |
Booleano | true |
includeworkoutmetadata |
Booleano | true |
workoutsmetadatainterval |
minutes o seconds; Versione 2 |
minutes |
workouttypes |
Identificatori di tipo di allenamento Apple senza segno, separati da virgole | Tutti i tipi |
Non includere opzioni di aggregazione delle metriche di salute in un link di allenamento.
Cadenza e notifiche
| Parametro | Valori o significato | Predefinito |
|---|---|---|
syncinterval |
minutes, hours, days, weeks |
minutes |
syncquantity |
Numero intero positivo di intervalli | 5 |
notifyonupdate |
Booleano; notificare dopo la preparazione dei dati | true |
notifywhenrun |
Booleano; notificare dopo un’azione corretta sulla destinazione | true |
La cadenza resta soggetta ai limiti di background e dei dati di salute; non è una pianificazione esatta.
Autenticazione e codifica
Il valore di headers consiste in chiavi e valori alternati:
headers=Authorization,Bearer%20YOUR_TOKEN,X-API-Key,YOUR_KEY
Ogni chiave richiede un valore. Le virgole separano le coppie, quindi evita valori di intestazione con virgole in questo formato di link. Codifica gli spazi come %20, i segni più come %2B e gli ampersand come %26. Codifica l’URL completo dell’endpoint quando ha i propri parametri di query.
Esempi
Metriche selezionate, riepilogate per ora
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
Allenamenti con percorsi
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
Entrambi gli esempi lasciano le esecuzioni automatiche disattivate finché non rivedi e abiliti l’automazione.
Risoluzione dei problemi
- Errore di URL o parametro: Inizia con l’URL minimo, controlla l’ortografia e la codifica, poi aggiungi le opzioni una alla volta.
- Metrica non valida: Usa il nome esatto della metrica, inclusi spazi e maiuscole.
- Errore di aggregazione: Usa le opzioni delle metriche di salute solo con
datatype=healthMetrics. - Errore di impostazioni allenamento: Usa le opzioni di allenamento con
datatype=workouts; il raggruppamento in secondi richiede la Versione 2. - Errore di batch: Imposta
format=jsonoppure disattivabatchrequests. - Cadenza/timeout non validi: Usa gli intervalli supportati, una quantità positiva e un timeout da 60 a 86400 secondi.
- URL troppo lungo: Riduci l’elenco di metriche/intestazioni oppure configura il resto nell’app.
Dopo la creazione, usa API REST — Esportare dati storici o mancati per caricare un intervallo selezionato o verificare la configurazione.