Sinkronizacija Apple Health podataka u REST API

Šaljite zdravstvene izvoze na krajnju točku koja prihvaća HTTP POST zahtjeve.

Važno — ograničenja automatizacija: Uređaj mora biti otključan da bi se mogli čitati zdravstveni podaci, a iOS ne jamči pokretanja u pozadini na odabranoj učestalosti. Prije oslanjanja na automatske izvoze pregledajte Ograničenja automatizacija.

Otvaranje automatizacije

Na iPhoneu otvorite Izvoz → Automatizirano ili na iPadu Automatizacije u bočnoj traci. Odaberite Nova automatizacija ili otvorite postojeću automatizaciju za uređivanje.

Naziv, status i obavijesti

Unesite naziv koji identificira ovu automatizaciju. Omogućeno dopušta automatska pokretanja; ostavite isključeno dok ne budete spremni.

Odaberite bilo koje obavijesti o pokretanju koje želite:

• Obavijesti pri ažuriranju predmemorije javlja da su podaci izvoza pripremljeni.
• Obavijesti pri pokretanju javlja uspješno učitavanje na vašu krajnju točku.

Dopustite obavijesti kada se to zatraži. Te obavijesti prijavljuju aktivnost; ne zakazuju pokretanje.

Postavljanje krajnje točke

1. Kao Tip automatizacije odaberite REST API.
2. Unesite URL dostupan s iPhonea ili iPada, na primjer https://api.example.com/health-data.
3. Pod HTTP zaglavlja dodajte potrebnu autentifikaciju. Na primjer, koristite Authorization kao ključ i Bearer YOUR_TOKEN kao njegovu vrijednost.
4. Odaberite Vremensko ograničenje zahtjeva prikladno za vašu krajnju točku.

Svako zaglavlje treba i ključ i vrijednost. Za poslužitelj na drugom uređaju koristite njegovu dostupnu mrežnu adresu umjesto localhost.

Postavke tipa podataka

Za ovu automatizaciju odaberite jedan Tip podataka: Zdravstvene metrike, Treninzi, Simptomi, ECG, Obavijesti o frekvenciji otkucaja srca, Stanje uma, Praćenje ciklusa ili Lijekovi. Stanje uma zahtijeva iOS 18 ili noviji; Lijekovi zahtijevaju iOS 26 ili noviji i zaseban pristup lijekovima.

Zdravstvene metrike

Odaberite Zdravstvene metrike, zatim otvorite Odaberi zdravstvene metrike i odaberite mjerenja koja trebate.

Da ograničite očitanja na određene aplikacije ili uređaje, otvorite Preferirani izvori, odaberite metriku i odaberite njezine izvore. Svi dopušta svaki izvor koji nije isključen. Koristite Isključeni izvori za zanemarivanje izvora u zdravstvenim metrikama ove automatizacije. Isključenja imaju prednost; neodabrani izvor ne zamjenjuje se kada preferirani izvor nema podataka. Odaberite Spremi za primjenu odabira izvora ili Odustani za njihovo odbacivanje.

Treninzi

Odaberite Treninzi za izvoz zapisa treninga. Uključi podatke rute dodaje dostupne točke rute u JSON podatke treninga. Ne stvara zasebna GPX učitavanja.

Za Verziju 2 uključite Uključi metrike treninga za dodavanje očitanja kao što su frekvencija otkucaja srca, aktivna energija i koraci. Za Vremensku grupaciju metrika treninga odaberite Minute ili Sekunde; sekunde proizvode više detalja i veće izvoze. Verzija 1 uvijek uključuje metrike treninga.

Postavke izvoza

Format izvoza

• JSON čuva strukturirane podatke za integracije i analizu.
• CSV stvara tablične datoteke za tablice.
• Markdown stvara čitljive naslove i tablice za bilješke i arhive.

Verzija izvoza

Odaberite Verziju 2 za trenutačnu strukturu podataka. Koristite Verziju 1 kada postojeći tijek rada ovisi o starijem formatu.

Raspon datuma

Odabir	Uključeni podaci
Zadano	Prethodni dan i današnji dan do vremena pokretanja
Od posljednje sinkronizacije	Od prethodne sinkronizacije do vremena pokretanja
Danas	Današnji dan do vremena pokretanja
Jučer	Prethodni puni dan
Prethodnih 7 dana	Prethodnih sedam punih dana

Sažmi podatke i vremenska grupacija

Za JSON + Zdravstvene metrike uključite Sažmi podatke za kombiniranje očitanja u vremenske grupe ili isključite za pojedinačna očitanja gdje su dostupna. Sažetak ovisi o metrici — na primjer, koraci se zbrajaju, a očitanja težine prosječe. CSV izvozi zdravstvenih metrika koriste sažete podatke.

Kada je dostupna Vremenska grupacija, odaberite koliko detalja zadržati. Satne ili dnevne grupe proizvode manje redaka od minutnih ili sekundnih. Dostupni odabiri ovise o rasponu datuma i formatu. Vremenska grupacija treninga konfigurira se zasebno pod Treninzima.

Grupni zahtjevi i veliki payloadi

Za REST API + JSON uključite Grupne zahtjeve za slanje podataka preko više zahtjeva. Koristite to kada vaša krajnja točka odbija velika tijela ili veliki zahtjevi isteknu. Primajuća usluga mora obraditi svaki zahtjev zasebno.

Grupiranje nije dostupno za CSV i Markdown. Smanjuje veličinu pojedinačnih zahtjeva, ali ne smanjuje količinu zdravstvenih podataka koje uređaj treba pročitati. Ako je priprema spora, pogledajte Performanse.

Zakazivanje podsjetnika

Ako želite podsjetnik da otključate i otvorite aplikaciju, uključite Omogući podsjetnike. Odaberite Satno, Svaki dan ili Odabrani dani, zatim postavite minutu, vrijeme i dane prema potrebi. Dopustite pristup obavijestima kada se to zatraži; ako je pristup odbijen, koristite Otvori postavke obavijesti.

Podsjetnik ne pokreće automatizaciju niti potvrđuje uspješnu sinkronizaciju. Dodirnite ga da otvorite automatizaciju ili koristite Otvori i sinkroniziraj na obavijesti za zahtjev pokretanja. Automatizacija mora biti omogućena; podsjetnik se još može pojaviti nakon uspješnog pokretanja u pozadini. Promjene podsjetnika primjenjuju se kada spremite.

Učestalost sinkronizacije i spremanje

Pod Učestalost sinkronizacije odaberite broj i Minute, Sate, Dane ili Tjedne — na primjer, svakih 15 minuta. To je željeni ritam u pozadini, a ne zajamčeni raspored.

Uređaj mora biti otključan kada se čitaju zdravstveni podaci. Omogućite osvježavanje aplikacije u pozadini za Health Auto Export i isključite način rada niske potrošnje za automatska pokretanja. iOS i dalje može odgoditi pokretanja kada je uređaj bio neaktivan ili su sustavski resursi ograničeni.

Uključite Omogućeno kada budete spremni za automatska pokretanja, zatim odaberite Ažuriraj za spremanje automatizacije. Odabrani raspon datuma možete odmah učitati koracima ispod.

Zaglavlja zahtjeva

Aplikacija postavlja Content-Type za odabrani format i uključuje:

Zaglavlje	Značenje
automation-name	Naziv automatizacije
automation-id	Identifikator automatizacije
automation-aggregation	Odabrana vremenska grupacija
automation-period	Odabrani raspon datuma
session-id	Identifikator zahtjeva

Izvoz povijesnih ili propuštenih podataka

Koristite Ručno učitavanje kada prvi put postavljate automatizaciju za izvoz povijesnih podataka ili kasnije za pokrivanje datuma koje je automatska sinkronizacija propustila. Također ga možete koristiti za provjeru postavki.

1. Otvorite automatizaciju i pod Izvezi postojeće podatke odaberite Ručno učitavanje.
2. Postavite datume Početak i Kraj, zatim odaberite Započni izvoz.
3. Provjerite primljeni zahtjev, zaglavlja i tijelo na krajnjoj točki.

Rješavanje problema

• Nijedan zahtjev nije primljen: Provjerite URL, dostupnost mreže i zapisnike poslužitelja.
• Pogreška autentifikacije: Provjerite ključ zaglavlja, token i dopuštenja krajnje točke.
• Payload odbijen ili istekao: Provjerite ograničenja veličine poslužitelja, koristite grupiranje za JSON ili smanjite veličinu izvoza.

Otvorite automatizaciju i odaberite Prikaži zapisnike aktivnosti za pregled pokretanja. Upozorenja označavaju potencijalne probleme kao što je sporo dohvaćanje podataka; pogreške identificiraju neuspješne korake. Za pomoć pri prijavi problema pogledajte Dobivanje pomoći.