Synchronizace dat Apple Health do REST API

Automatizace REST API umožňují automaticky exportovat zdravotní data do libovolné webové služby, která přijímá HTTP POST požadavky. To je ideální pro integraci s vlastním backendem, API třetích stran nebo webhooky.

Přehled

Automatizace REST API odesílají vaše zdravotní data na zadaný URL endpoint pomocí HTTP POST požadavků. Automatizace může data posílat ve formátu JSON nebo CSV a podporuje nastavitelné hlavičky pro ověřování i vlastní metadata.

Případy použití:

• integrace s vlastním backendem
• odesílání dat do webhooků
• synchronizace s API třetích stran
• vytváření vlastních dashboardů nebo analytických platforem

Klíčové funkce:

• podpora formátů JSON i CSV
• vlastní HTTP hlavičky pro ověřování
• nastavitelné časové limity požadavků
• možnost ručně exportovat historická data

Omezení

• Přístup ke zdravotním datům: Aplikace nemají povolený přístup ke zdravotním datům, když je iPhone zamknutý. Automatizace proto poběží jen v době, kdy je zařízení odemčené. To může ovlivnit aktuálnost dat. Pokud potřebujete data udržovat aktuální, podívejte se na pokyny pro ruční synchronizaci.

• Zpracování na pozadí: iOS omezuje zpracování na pozadí kvůli šetření baterie. Automatizace spoléhají na Obnovení aplikací na pozadí a nemusí se spustit okamžitě, pokud:

  • je pro aplikaci vypnuté Obnovení aplikací na pozadí
  • je zařízení v režimu nízké spotřeby
  • bylo zařízení delší dobu neaktivní
  • jsou systémové prostředky omezené
  • si více aplikací současně nárokuje čas pro běh na pozadí

Předpoklady

• platný URL endpoint, který přijímá HTTP POST požadavky
• přihlašovací údaje nebo jiné ověření, pokud je endpoint vyžaduje
• síťové připojení, aby bylo možné endpoint kontaktovat

Konfigurace

V hlavní navigaci přejděte na obrazovku Automated Exports, klepněte na „New Automation“ a jako typ automatizace vyberte „REST API“.

Název automatizace

Zadejte popisný název automatizace, například „Moje backend API“ nebo „Integrace webhooku“.

Oznámení

Nastavte, kdy chcete dostávat oznámení:

• Oznámit při aktualizaci mezipaměti - dostanete oznámení při aktualizaci dat v mezipaměti
• Oznámit při spuštění - dostanete oznámení při každém spuštění automatizace

Konfigurace URL

Zadejte úplnou adresu URL, na kterou chcete svá zdravotní data odesílat. Musí jít o kompletní URL včetně protokolu http:// nebo https://.

Příklady URL:

• https://api.example.com/health-data
• https://webhook.site/your-unique-id
• http://localhost:3000/api/health

Poznámka: URL musí být platná a dostupná z vašeho zařízení. Neplatná URL zabrání spuštění automatizace.

Časový limit požadavku

Vyberte časový limit pro HTTP požadavky. Tato hodnota určuje, jak dlouho bude aplikace čekat na odpověď, než požadavek vyhodnotí jako neúspěšný.

HTTP hlavičky

Přidejte vlastní HTTP hlavičky pro ověřování nebo metadata. Mezi běžné případy použití patří:

• API klíče: X-API-Key: your-api-key
• autorizační tokeny: Authorization: Bearer your-token
• přepsání typu obsahu: Content-Type: application/json

Postup přidání hlaviček:

1. Klepněte na „Přidat hlavičky“.
2. Do levého pole zadejte název hlavičky.
3. Do pravého pole zadejte hodnotu hlavičky.
4. Stejný postup opakujte pro další hlavičky.

Důležité: Každý klíč hlavičky musí mít odpovídající hodnotu. Prázdné hlavičky budou ignorovány.

Nastavení typu dat

Typ dat

Vyberte, jaký typ zdravotních dat chcete exportovat:

• Zdravotní metriky - kroky, tepová frekvence, spánek a další zdravotní měření
• Tréninky - cvičení a fitness aktivity
• Příznaky - zdravotní příznaky a stavy
• EKG - záznamy elektrokardiogramu
• Oznámení o srdeční frekvenci - události vysoké nebo nízké tepové frekvence
• Duševní stav - záznamy nálady a duševního stavu (iOS 18.0+)
• Sledování cyklu - data o menstruačním cyklu a reprodukčním zdraví
• Léky - záznamy léků a dodržování léčby (iOS 26.0+)

Konfigurace zdravotních metrik

Když vyberete Zdravotní metriky:

Vybrat zdravotní metriky - zvolte konkrétní metriky, které chcete zahrnout. Můžete vybrat všechny dostupné metriky nebo jen některé.

Tip: Výběr jen těch metrik, které skutečně potřebujete, může zrychlit zpracování a zmenšit objem dat.

Preferované zdroje - nastavte, které zdroje dat mají mít přednost, když stejnou metriku poskytuje více zdrojů.

Konfigurace tréninků

Když vyberete Tréninky:

Zahrnout data trasy - zapněte, pokud chcete zahrnout trasy u tréninků, které mají polohová data.

Zahrnout metriky tréninku - zapněte, pokud chcete zahrnout zdravotní metriky zaznamenané během tréninku, například tepovou frekvenci, kalorie a podobně.

Seskupení podle času (metriky tréninku) - když používáte verzi exportu 2 a máte zapnuté metriky tréninku:

• Minuty - seskupí metriky tréninku po minutách
• Sekundy - seskupí metriky tréninku po sekundách

Nastavení exportu

Formát exportu

Vyberte formát exportovaných dat:

• Formát JSON - poskytuje podrobné datové struktury s vnořenými objekty. Je nejlepší pro API, databáze a aplikace, které potřebují strukturovaná data. JSON obsahuje více detailů pro složité typy dat, například fáze spánku a záznamy AFib.

• Formát CSV - poskytuje tabulková data, která lze snadno importovat do tabulkových aplikací. Je vhodný pro jednoduchou analýzu dat nebo pokud váš endpoint očekává data CSV.

Poznámka: Hlavička Content-Type se pro exporty JSON automaticky nastaví na application/json a pro exporty CSV na multipart/form-data.

Verze exportu

Vyberte verzi exportu. Verze umožňují přechod mezi novějšími formáty exportu vlastním tempem a minimalizují nekompatibilní změny ve workflow.

• Verze 1 - starší formát, použijte jej, pokud na něm závisí vaše stávající workflow
• Verze 2 - aktuální formát s rozšířenými daty o trénincích a podrobnějšími možnostmi metadat

Rozsah dat

Vyberte, jaké období se má exportovat:

• Default - synchronizuje všechna data za celý předchozí den plus data až do aktuálního data a času
• Since Last Sync - při každé synchronizaci exportuje všechna data od posledního běhu exportu do aktuálního data a času
• Today - synchronizuje všechna data za dnešní den až do aktuálního času
• Yesterday - synchronizuje všechna data za celý předchozí den
• Previous 7 Days - synchronizuje data za celých předchozích sedm dní

Souhrnná data

Když používáte formát JSON s datovým typem Zdravotní metriky, zapněte nebo vypněte volbu Souhrnná data.

• ON - poskytuje agregované souhrny dat
• OFF - tam, kde je to možné, poskytuje neagregovaná data s jednotlivými datovými body

Poznámka: Toto nastavení platí jen pro formát JSON se Zdravotními metrikami. Při použití formátu CSV nebo při výběru více metrik se data vždy agregují.

Seskupení podle času

Pokud používáte formát JSON se zapnutou volbou Souhrnná data, vyberte, jak se mají data agregovat.

Poznámka: Formát CSV data agreguje vždy. Agregace po minutách nebo sekundách může výrazně zvýšit dobu zpracování i velikost dat.

Dávkové požadavky

Při použití formátu JSON zapněte volbu Dávkové požadavky, pokud chcete data odesílat v dávkách prostřednictvím více požadavků místo jednoho velkého payloadu.

• ON - rozdělí data do více požadavků, aby se předešlo příliš velkým payloadům
• OFF - odešle všechna data v jediném požadavku

Frekvence synchronizace

Nastavte, jak často má automatizace data odesílat:

Vyberte číslo a časový interval.

Testování a ověření

Ruční testování

1. Na obrazovce konfigurace automatizace klepněte na „Manual Export“.
2. Vyberte rozsah dat.
3. Klepnutím na „Export“ odešlete testovací požadavek.
4. Na svém endpointu ověřte, že data byla přijata.

Zobrazení protokolů aktivity

1. Na obrazovce konfigurace automatizace klepněte na „View Activity Logs“.
2. Zkontrolujte poslední běhy automatizace.
3. Podívejte se, zda se nevyskytly chyby nebo varování.
4. Ověřte časová razítka požadavků a stav odpovědi.

Ověření formátu dat

Aplikace automaticky přidává do každého požadavku tyto hlavičky:

• Content-Type - nastaví se podle formátu exportu
• automation-name - název automatizace
• automation-id - jedinečný identifikátor automatizace
• automation-aggregation - zvolené seskupení podle času
• automation-period - zvolený rozsah dat
• session-id - jedinečný identifikátor každého požadavku

Řešení problémů

Časté problémy

Data endpoint neobdržel

• ověřte, že je URL endpointu správná
• zkontrolujte, zda endpoint přijímá POST požadavky
• zkontrolujte ověřovací hlavičky
• podívejte se do logů endpointu na příchozí požadavky
• ověřte síťové připojení

Tipy a osvědčené postupy

1. Automatická synchronizace:

   • Nabíjejte zařízení a používejte iPhone Mirroring.
     • Když se zařízení nabíjí, iOS klade menší omezení na výkon, takže se data mohou synchronizovat častěji.
     • Při použití iPhone Mirroring se zařízení chová podobně, jako kdyby bylo odemčené. Health Auto Export tak může přistupovat ke zdravotním datům a spouštět automatické akce.

2. Výkon:

   • Zvolte vhodné seskupení podle času, abyste vyvážili detailnost a velikost dat.
   • Vybírejte jen metriky, které skutečně potřebujete.

3. Spolehlivost:

   • Nastavte vhodné časové limity podle rychlosti odpovědi vašeho endpointu.
   • Pravidelně sledujte Activity Logs.

4. Formát dat:

   • JSON používejte pro strukturovaná data a API.
   • CSV používejte pro jednoduchou analýzu dat nebo integraci s tabulkami.
   • U velkých datových sad nebo odděleného zpracování zvažte dávkové požadavky.