Synchronizace dat Apple Health do REST API

Odesílejte zdravotní exporty na koncový bod, který přijímá HTTP POST požadavky.

Důležité — omezení automatizací: Zařízení musí být odemčené, aby bylo možné číst zdravotní data, a iOS negarantuje běhy na pozadí ve zvolené frekvenci. Před spoléháním na automatické exporty si prohlédněte Omezení automatizací.

Otevření automatizace

Na iPhonu otevřete Export → Automatizované, nebo na iPadu Automatizace v postranním panelu. Vyberte Nová automatizace, nebo otevřete existující automatizaci k úpravě.

Název, stav a oznámení

Zadejte název, který tuto automatizaci identifikuje. Zapnuto umožňuje automatické běhy; nechte vypnuté, dokud nebudete připraveni.

Zvolte libovolná oznámení o běhu:

• Oznámit při aktualizaci mezipaměti hlásí, že data exportu byla připravena.
• Oznámit při běhu hlásí úspěšné nahrání na váš koncový bod.

Na výzvu povolte oznámení. Tato oznámení hlásí aktivitu; nenaplánují běh.

Nastavení koncového bodu

1. Jako Typ automatizace zvolte REST API.
2. Zadejte URL dostupnou z iPhonu nebo iPadu, například https://api.example.com/health-data.
3. Pod HTTP hlavičky přidejte požadovanou autentizaci. Například použijte Authorization jako klíč a Bearer YOUR_TOKEN jako jeho hodnotu.
4. Zvolte Časový limit požadavku vhodný pro váš koncový bod.

Každá hlavička potřebuje klíč i hodnotu. Pro server na jiném zařízení použijte jeho dostupnou síťovou adresu místo localhost.

Nastavení typu dat

Pro tuto automatizaci vyberte jeden Typ dat: Zdravotní metriky, Tréninky, Symptomy, EKG, Oznámení o tepové frekvenci, Stav mysli, Sledování cyklu nebo Léky. Stav mysli vyžaduje iOS 18 nebo novější; Léky vyžadují iOS 26 nebo novější a samostatný přístup k lékům.

Zdravotní metriky

Zvolte Zdravotní metriky, poté otevřete Vybrat zdravotní metriky a vyberte potřebná měření.

Chcete-li omezit čtení na konkrétní aplikace nebo zařízení, otevřete Preferované zdroje, zvolte metriku a vyberte její zdroje. Vše povoluje každý zdroj, který nebyl vyloučen. Použijte Vyloučené zdroje k ignorování zdroje napříč zdravotními metrikami této automatizace. Vyloučení mají přednost; nevybraný zdroj se nenahrazuje, když preferovaný zdroj nemá data. Vyberte Uložit pro použití voleb zdrojů, nebo Zrušit pro jejich zrušení.

Tréninky

Zvolte Tréninky pro export záznamů tréninků. Zahrnout data trasy přidává dostupné body trasy do JSON dat tréninku. Nevytváří samostatná nahrání GPX.

Pro Verzi 2 zapněte Zahrnout metriky tréninku pro přidání čtení, jako je tepová frekvence, aktivní energie a kroky. Pro Časové seskupení metrik tréninku zvolte Minuty nebo Sekundy; sekundy produkují více detailů a větší exporty. Verze 1 vždy zahrnuje metriky tréninku.

Nastavení exportu

Formát exportu

• JSON zachovává strukturovaná data pro integrace a analýzu.
• CSV vytváří tabulkové soubory pro tabulkové procesory.
• Markdown vytváří čitelné nadpisy a tabulky pro poznámky a archivy.

Verze exportu

Zvolte Verzi 2 pro aktuální strukturu dat. Použijte Verzi 1, když stávající workflow závisí na starším formátu.

Časové období

Výběr	Zahrnutá data
Výchozí	Předchozí den a dnešek až do času běhu
Od poslední synchronizace	Od předchozí synchronizace až do času běhu
Dnes	Dnešek až do času běhu
Včera	Předchozí celý den
Předchozích 7 dní	Předchozích sedm celých dní

Shrnout data a časové seskupení

Pro JSON + Zdravotní metriky zapněte Shrnout data pro kombinování čtení do časových skupin, nebo vypněte pro jednotlivá čtení, kde jsou dostupná. Shrnutí závisí na metrice — například kroky se sčítají a čtení hmotnosti se průměrují. CSV exporty zdravotních metrik používají shrnutá data.

Když je dostupné Časové seskupení, zvolte, kolik detailů zachovat. Hodinové nebo denní skupiny produkují méně řádků než minutové nebo sekundové. Dostupné volby závisí na časovém období a formátu. Časové seskupení tréninků se konfiguruje samostatně pod Tréninky.

Dávkové požadavky a velké payloady

Pro REST API + JSON zapněte Dávkové požadavky pro odesílání dat napříč více požadavky. Použijte to, když váš koncový bod odmítá velká těla nebo velké požadavky vyprší. Přijímající služba musí zpracovat každý požadavek samostatně.

Dávkování není dostupné pro CSV a Markdown. Snižuje velikost jednotlivých požadavků, ale nesnižuje množství zdravotních dat, která zařízení potřebuje načíst. Pokud je příprava pomalá, viz Výkon.

Plánování připomínek

Chcete-li výzvu k odemčení a otevření aplikace, zapněte Povolit připomínky. Zvolte Hodinově, Každý den nebo Vybrané dny a nastavte minutu, čas a dny podle potřeby. Na výzvu povolte přístup k oznámením; pokud je přístup odepřen, použijte Otevřít nastavení oznámení.

Připomínka nespouští automatizaci ani nepotvrzuje úspěšnou synchronizaci. Klepnutím ji otevřete, nebo použijte Otevřít a synchronizovat na oznámení k vyžádání běhu. Automatizace musí být zapnutá; připomínka se může stále objevit po úspěšném běhu na pozadí. Změny připomínek se projeví při uložení.

Frekvence synchronizace a uložení

Pod Frekvence synchronizace zvolte číslo a Minuty, Hodiny, Dny nebo Týdny — například každých 15 minut. Jedná se o požadovaný rytmus na pozadí, nikoli o garantovaný plán.

Zařízení musí být odemčené, když se čtou zdravotní data. Povolte Obnovování na pozadí pro Health Auto Export a vypněte Režim nízké spotřeby pro automatické běhy. iOS může běhy stále zpozdit, když bylo zařízení neaktivní nebo jsou omezené systémové prostředky.

Zapněte Zapnuto, až budete připraveni na automatické běhy, a poté vyberte Aktualizovat pro uložení automatizace. Vybrané časové období můžete nahrát ihned pomocí kroků níže.

Hlavičky požadavku

Aplikace nastavuje Content-Type pro zvolený formát a zahrnuje:

Hlavička	Význam
automation-name	Název automatizace
automation-id	Identifikátor automatizace
automation-aggregation	Vybrané časové seskupení
automation-period	Vybrané časové období
session-id	Identifikátor požadavku

Export historických nebo zmeškaných dat

Použijte Manuální nahrání, když automatizaci poprvé nastavujete pro export historických dat, nebo později k pokrytí dat zmeškaných automatickou synchronizací. Můžete jej také použít ke kontrole nastavení.

1. Otevřete automatizaci a pod Exportovat existující data vyberte Manuální nahrání.
2. Nastavte data Začátek a Konec a poté vyberte Zahájit export.
3. Zkontrolujte přijatý požadavek, hlavičky a tělo na koncovém bodě.

Řešení problémů

• Žádný požadavek nepřijat: Zkontrolujte URL, dostupnost sítě a protokoly serveru.
• Chyba autentizace: Zkontrolujte klíč hlavičky, token a oprávnění koncového bodu.
• Payload odmítnut nebo vypršel: Zkontrolujte limity velikosti serveru, použijte dávkování pro JSON, nebo snižte velikost exportu.

Otevřete automatizaci a vyberte Zobrazit protokoly aktivity pro kontrolu běhu. Varování označují potenciální problémy, například pomalé načítání dat; chyby identifikují neúspěšné kroky. Pro pomoc s nahlášením problému viz Získání pomoci.