Synchronizácia údajov Apple Health do REST API

Odosielajte zdravotné exporty na koncový bod, ktorý prijíma HTTP POST požiadavky.

Dôležité — obmedzenia automatizácií: Zariadenie musí byť odomknuté na čítanie zdravotných údajov a iOS negarantuje beh na pozadí vo zvolenej frekvencii. Pred spoľahnutím sa na automatické exporty skontrolujte Obmedzenia automatizácií.

Otvorenie automatizácie

Na iPhone otvorte Export → Automatizované, alebo na iPade Automatizácie na bočnom paneli. Vyberte Nová automatizácia alebo otvorte existujúcu automatizáciu na úpravu.

Názov, stav a oznámenia

Zadajte názov, ktorý identifikuje túto automatizáciu. Zapnuté umožňuje automatické spustenia; nechajte vypnuté, kým nebudete pripravení.

Vyberte ľubovoľné oznámenia o spustení:

• Upozorniť pri aktualizácii vyrovnávacej pamäte hlási, že exportné údaje boli pripravené.
• Upozorniť pri spustení hlási úspešné nahratie na váš koncový bod.

Pri výzve povoľte oznámenia. Tieto oznámenia hlásia aktivitu; neplánujú spustenie.

Nastavenie koncového bodu

1. Ako Typ automatizácie zvoľte REST API.
2. Zadajte URL dostupnú z iPhonu alebo iPadu, napríklad https://api.example.com/health-data.
3. V časti HTTP hlavičky pridajte požadované overenie. Napríklad použite Authorization ako kľúč a Bearer YOUR_TOKEN ako hodnotu.
4. Zvoľte Časový limit požiadavky vhodný pre váš koncový bod.

Každá hlavička potrebuje kľúč aj hodnotu. Pre server na inom zariadení použite jeho dostupnú sieťovú adresu namiesto localhost.

Nastavenia typu údajov

Vyberte jeden Typ údajov pre túto automatizáciu: Zdravotné metriky, Tréningy, Príznaky, ECG, Oznámenia o srdcovej frekvencii, Stav mysle, Sledovanie cyklu alebo Lieky. Stav mysle vyžaduje iOS 18 alebo novší; Lieky vyžadujú iOS 26 alebo novší a samostatný prístup k liekom.

Zdravotné metriky

Zvoľte Zdravotné metriky, potom otvorte Vybrať zdravotné metriky a vyberte potrebné merania.

Ak chcete obmedziť hodnoty na konkrétne aplikácie alebo zariadenia, otvorte Preferované zdroje, zvoľte metriku a vyberte jej zdroje. Všetky povoľuje každý zdroj, ktorý nebol vylúčený. Použite Vylúčené zdroje na ignorovanie zdroja vo všetkých zdravotných metrikách tejto automatizácie. Vylúčenia majú prednosť; nevybraný zdroj sa nenahrádza, keď preferovaný zdroj nemá údaje. Vyberte Uložiť na použitie volieb zdrojov alebo Zrušiť na ich zahodenie.

Tréningy

Zvoľte Tréningy na export záznamov tréningov. Zahrnúť údaje trasy pridá dostupné body trasy do JSON údajov tréningu. Nevytvára samostatné nahratia GPX.

Pre Verziu 2 zapnite Zahrnúť metriky tréningu, aby ste pridali hodnoty, napríklad srdcovú frekvenciu, aktívnu energiu a kroky. Pre Časové zoskupenie metrík tréningu zvoľte Minúty alebo Sekundy; sekundy produkujú viac detailov a väčšie exporty. Verzia 1 vždy zahŕňa metriky tréningu.

Nastavenia exportu

Formát exportu

• JSON zachováva štruktúrované údaje pre integrácie a analýzu.
• CSV vytvára tabuľkové súbory pre tabuľkové procesory.
• Markdown vytvára čitateľné nadpisy a tabuľky pre poznámky a archívy.

Verzia exportu

Zvoľte Verziu 2 pre aktuálnu dátovú štruktúru. Použite Verziu 1, keď existujúci pracovný postup závisí od staršieho formátu.

Rozsah dátumov

Výber	Zahrnuté údaje
Predvolené	Predchádzajúci deň a dnešok až do času spustenia
Od poslednej synchronizácie	Od predchádzajúcej synchronizácie až do času spustenia
Dnes	Dnešok až do času spustenia
Včera	Predchádzajúci celý deň
Predchádzajúcich 7 dní	Predchádzajúcich sedem celých dní

Sumarizovať údaje a časové zoskupenie

Pre JSON + Zdravotné metriky zapnite Sumarizovať údaje na spojenie hodnôt do časových skupín, alebo vypnite pre jednotlivé hodnoty, kde sú dostupné. Súhrn závisí od metriky — napríklad kroky sa sčítajú a hodnoty hmotnosti sa spriemerujú. CSV exporty zdravotných metrík používajú sumarizované údaje.

Keď je dostupné Časové zoskupenie, zvoľte, koľko detailov zachovať. Hodinové alebo denné skupiny produkujú menej riadkov než minútové alebo sekundové. Dostupné voľby závisia od rozsahu dátumov a formátu. Časové zoskupenie tréningov sa nastavuje samostatne v Tréningoch.

Dávkové požiadavky a veľké dátové balíky

Pre REST API + JSON zapnite Dávkové požiadavky, aby sa údaje odosielali vo viacerých požiadavkách. Použite to, keď váš koncový bod odmieta veľké telá alebo veľké požiadavky vypršajú. Prijímajúca služba musí spracovať každú požiadavku samostatne.

Dávkovanie nie je dostupné pre CSV a Markdown. Znižuje veľkosť jednotlivých požiadaviek, ale neznižuje množstvo zdravotných údajov, ktoré zariadenie potrebuje načítať. Ak je príprava pomalá, pozrite Výkon.

Plánovanie pripomienok

Ak chcete výzvu odomknúť a otvoriť aplikáciu, zapnite Zapnúť pripomienky. Zvoľte Každú hodinu, Každý deň alebo Vybrané dni a potom podľa potreby nastavte minútu, čas a dni. Pri výzve povoľte prístup k oznámeniam; ak je prístup zamietnutý, použite Otvoriť nastavenia oznámení.

Pripomienka nespúšťa automatizáciu ani nepotvrdzuje úspešnú synchronizáciu. Klepnutím ju otvoríte, alebo na oznámení použite Otvoriť a synchronizovať na požiadanie spustenia. Automatizácia musí byť zapnutá; pripomienka sa môže zobraziť aj po úspešnom behu na pozadí. Zmeny pripomienok platia pri uložení.

Frekvencia synchronizácie a uloženie

V časti Frekvencia synchronizácie zvoľte číslo a Minúty, Hodiny, Dni alebo Týždne — napríklad každých 15 minút. Ide o požadovanú kadenciu na pozadí, nie o zaručený rozvrh.

Zariadenie musí byť odomknuté, keď sa čítajú zdravotné údaje. Pre automatické spustenia zapnite Obnovenie aplikácií na pozadí pre Health Auto Export a vypnite režim nízkej spotreby. iOS môže spustenia stále oneskoriť, keď bolo zariadenie neaktívne alebo sú systémové zdroje obmedzené.

Keď ste pripravení na automatické spustenia, zapnite Zapnuté a potom vyberte Aktualizovať na uloženie automatizácie. Vybraný rozsah dátumov môžete okamžite nahrať podľa krokov nižšie.

Hlavičky požiadavky

Aplikácia nastaví Content-Type pre zvolený formát a zahrnie:

Hlavička	Význam
automation-name	Názov automatizácie
automation-id	Identifikátor automatizácie
automation-aggregation	Vybrané časové zoskupenie
automation-period	Vybraný rozsah dátumov
session-id	Identifikátor požiadavky

Export historických alebo vynechaných údajov

Použite Manuálne nahratie, keď automatizáciu prvýkrát nastavujete na export historických údajov, alebo neskôr na pokrytie dátumov, ktoré automatická synchronizácia vynechala. Môžete ho použiť aj na overenie nastavenia.

1. Otvorte automatizáciu a v časti Exportovať existujúce údaje vyberte Manuálne nahratie.
2. Nastavte dátumy Začiatok a Koniec a potom vyberte Začať export.
3. Skontrolujte prijatú požiadavku, hlavičky a telo na vašom koncovom bode.

Riešenie problémov

• Žiadna požiadavka neprišla: Skontrolujte URL, sieťovú dostupnosť a denníky servera.
• Chyba overenia: Skontrolujte kľúč hlavičky, token a povolenia koncového bodu.
• Dátový balík odmietnutý alebo vypršal: Skontrolujte limity veľkosti servera, pre JSON použite dávkovanie alebo znížte veľkosť exportu.

Otvorte automatizáciu a vyberte Zobraziť denníky aktivity na kontrolu spustenia. Upozornenia označujú potenciálne problémy, napríklad pomalé načítanie údajov; chyby identifikujú zlyhané kroky. Pre pomoc pri nahlásení problému pozrite Získanie pomoci.