Sincronizzare i dati di Apple Health con API REST
Invia dati di salute a un endpoint API REST.
Ultimo aggiornamento: 31 ottobre 2026
In questa pagina
Impostazioni di esportazione
Impostazioni di esportazione Formato di esportazioneVersione di esportazioneIntervallo di dateRiepiloga dati e raggruppamento temporaleInvia esportazioni di salute a un endpoint che accetti richieste HTTP POST.
Importante — limitazioni delle automazioni: Il dispositivo deve essere sbloccato per leggere i dati di salute, e iOS non garantisce esecuzioni in background alla frequenza che scegli. Rivedi le limitazioni delle automazioni prima di affidarti alle esportazioni automatiche.
Aprire l’automazione
Apri Esporta → Automatico su iPhone, oppure Automazioni nella barra laterale dell’iPad. Seleziona Nuova automazione, oppure apri una esistente per modificarla.
Nome, stato e notifiche
Inserisci un nome che identifichi questa automazione. Attivato consente le esecuzioni automatiche; lascialo disattivato finché non sei pronto.
Scegli le notifiche di esecuzione che vuoi:
- Notifica all’aggiornamento della cache indica che sono stati preparati i dati di esportazione.
- Notifica all’esecuzione indica un caricamento corretto sul tuo endpoint.
Consenti le notifiche quando richiesto. Queste notifiche informano sull’attività; non programmano un’esecuzione.
Configurare l’endpoint
- Scegli API REST come Tipo di automazione.
- Inserisci un URL accessibile dal tuo iPhone o iPad, ad esempio
https://api.example.com/health-data. - Aggiungi l’autenticazione necessaria in Intestazioni HTTP. Ad esempio, usa
Authorizationcome chiave eBearer YOUR_TOKENcome valore. - Scegli un Timeout della richiesta adeguato al tuo endpoint.
Ciascuna intestazione necessita di chiave e valore. Per un server su un altro dispositivo, usa il suo indirizzo di rete accessibile invece di localhost.
Impostazioni del tipo di dati
Seleziona un Tipo di dati per questa automazione: Metriche di salute, Allenamenti, Sintomi, ECG, Notifiche della frequenza cardiaca, Stato d’animo, Monitoraggio del ciclo o Farmaci. Stato d’animo richiede iOS 18 o successivo; Farmaci richiede iOS 26 o successivo e accesso separato ai farmaci.
Metriche di salute
Scegli Metriche di salute, apri Seleziona metriche di salute e seleziona le misurazioni di cui hai bisogno.
Per limitare le letture ad app o dispositivi specifici, apri Origini preferite, scegli una metrica e seleziona le sue origini. Tutte consente tutte le origini non escluse. Usa Origini escluse per ignorare un’origine nelle metriche di salute di questa automazione. Le esclusioni hanno priorità; non viene sostituita un’origine non selezionata quando quella preferita non ha dati. Seleziona Salva per applicare le opzioni di origine oppure Annulla per scartarle.
Allenamenti
Scegli Allenamenti per esportare i record di allenamento. Includi dati del percorso aggiunge i punti del percorso disponibili ai dati JSON dell’allenamento. Non crea file GPX indipendenti.
Per la Versione 2, attiva Includi metriche dell’allenamento per aggiungere letture come frequenza cardiaca, energia attiva e passi. Scegli Minuti o Secondi per il Raggruppamento temporale delle metriche dell’allenamento; i secondi producono più dettaglio ed esportazioni più grandi. La Versione 1 include sempre le metriche dell’allenamento.
Impostazioni di esportazione
Formato di esportazione
- JSON conserva dati strutturati per integrazioni e analisi.
- CSV crea file tabulari per fogli di calcolo.
- Markdown crea intestazioni e tabelle leggibili per note e file.
Versione di esportazione
Scegli Versione 2 per la struttura dati attuale. Usa Versione 1 quando un flusso esistente dipende dal formato precedente.
Intervallo di date
| Selezione | Dati inclusi |
|---|---|
| Predefinito | Il giorno precedente e oggi fino all’ora dell’esecuzione |
| Dall’ultima sincronizzazione | Dalla sincronizzazione precedente fino all’ora dell’esecuzione |
| Oggi | Oggi fino all’ora dell’esecuzione |
| Ieri | L’intero giorno precedente |
| Ultimi 7 giorni | I sette giorni interi precedenti |
Riepiloga dati e raggruppamento temporale
Per JSON + Metriche di salute, attiva Riepiloga dati per combinare le letture in gruppi temporali, oppure disattivalo per letture individuali quando disponibili. Il riepilogo dipende dalla metrica—ad esempio, i passi vengono sommati e le letture del peso vengono mediate. Le esportazioni CSV delle metriche di salute usano dati riepilogati.
Quando è disponibile Raggruppamento temporale, scegli quanto dettaglio conservare. I gruppi per ora o per giorno producono meno righe di quelli per minuto o secondo. Le opzioni disponibili dipendono dall’intervallo di date e dal formato. Il raggruppamento temporale degli allenamenti si configura separatamente in Allenamenti.
Richieste batch e payload grandi
Per API REST + JSON, attiva Richieste batch per inviare i dati in più richieste. Usalo quando il tuo endpoint rifiuta corpi grandi o le richieste grandi scadono. Il servizio ricevente deve gestire ciascuna richiesta separatamente.
I batch non sono disponibili per CSV né Markdown. Riducono le dimensioni di ciascuna richiesta, ma non la quantità di dati di salute che il dispositivo deve leggere. Consulta Prestazioni se la preparazione è lenta.
Programma promemoria
Se vuoi un avviso per sbloccare e aprire l’app, attiva Attiva promemoria. Scegli Ogni ora, Tutti i giorni o Giorni selezionati e configura il minuto, l’ora e i giorni come appropriato. Consenti l’accesso alle notifiche quando richiesto; se viene rifiutato, usa Apri le impostazioni delle notifiche.
Un promemoria non esegue l’automazione né conferma una sincronizzazione corretta. Toccalo per aprire l’automazione, oppure usa Apri e sincronizza nella notifica per richiedere un’esecuzione. L’automazione deve essere abilitata; un promemoria può comparire anche dopo un’esecuzione in background corretta. Le modifiche ai promemoria si applicano al salvataggio.
Frequenza di sincronizzazione e salvataggio
Scegli un numero e Minuti, Ore, Giorni o Settimane in Frequenza di sincronizzazione—ad esempio, ogni 15 minuti. È una cadenza desiderata in background, non una pianificazione garantita.
Il dispositivo deve essere sbloccato quando vengono letti i dati di salute. Attiva Aggiornamento in background per Health Auto Export e disattiva la modalità Risparmio energetico per le esecuzioni automatiche. iOS può ritardare le esecuzioni se il dispositivo è rimasto inattivo o le risorse di sistema sono limitate.
Attiva Attivato quando sei pronto per le esecuzioni automatiche e seleziona Aggiorna per salvare l’automazione. Puoi caricare subito un intervallo di date con i passaggi seguenti.
Intestazioni della richiesta
L’app imposta Content-Type per il formato scelto e include:
| Intestazione | Significato |
|---|---|
automation-name |
Nome dell’automazione |
automation-id |
Identificatore dell’automazione |
automation-aggregation |
Raggruppamento temporale selezionato |
automation-period |
Intervallo di date selezionato |
session-id |
Identificatore della richiesta |
Esportare dati storici o mancati
Usa Caricamento manuale quando configuri per la prima volta l’automazione per esportare dati storici, oppure più avanti per coprire date che la sincronizzazione automatica non ha raggiunto. Puoi anche usarla per verificare la configurazione.
- Apri l’automazione e seleziona Caricamento manuale in Esporta dati esistenti.
- Imposta le date di Inizio e Fine e seleziona Avvia esportazione.
- Controlla la richiesta ricevuta sul tuo endpoint, le intestazioni e il corpo.
Risoluzione dei problemi
- Nessuna richiesta ricevuta: Controlla l’URL, l’accessibilità della rete e i registri del server.
- Errore di autenticazione: Controlla la chiave dell’intestazione, il token e i permessi dell’endpoint.
- Payload rifiutato o timeout: Controlla i limiti di dimensione del server, usa i batch per JSON oppure riduci le dimensioni dell’esportazione.
Apri l’automazione e seleziona Visualizza registri attività per rivedere un’esecuzione. Le avvertenze segnalano possibili problemi come un recupero dati lento; gli errori identificano passaggi non riusciti. Per aiuto nella segnalazione di un problema, consulta Ottenere aiuto.