Centro assistenza HealthyApps
Italiano
Centro assistenza
Sito principale ↗

Cerca argomenti di assistenza

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
Formato URL
Riferimento dei parametri Riferimento dei parametri Impostazioni di baseMetriche di saluteAllenamentiCadenza e notifiche
Autenticazione e codifica
Esempi Esempi Metriche selezionate, riepilogate per oraAllenamenti con percorsi
Risoluzione dei problemiDocumentazione correlata

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=json oppure disattiva batchrequests.
  • 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.

Documentazione correlata