Synkronoi Apple Health -tiedot REST API:in

Lähetä terveysvientejä päätepisteeseen, joka vastaanottaa HTTP POST -pyyntöjä.

Tärkeää — automaatioiden rajoitukset: Laitteen on oltava lukitsematta, jotta terveystietoja voidaan lukea, eikä iOS takaa taustasuorituksia valitsemallasi tiheydellä. Ennen kuin luotat automaattisiin vienteihin, tutustu Automaatioiden rajoituksiin.

Automaation avaaminen

iPhonessa avaa Vie → Automatisoitu tai iPadissa Automaatiot sivupalkissa. Valitse Uusi automaatio tai avaa olemassa oleva automaatio muokattavaksi.

Nimi, tila ja ilmoitukset

Anna nimi, joka tunnistaa tämän automaation. Käytössä sallii automaattiset suoritukset; jätä se pois päältä, kunnes olet valmis.

Valitse haluamasi suoritusilmoitukset:

• Ilmoita välimuistin päivityksestä ilmoittaa, että vientitiedot valmisteltiin.
• Ilmoita suorituksesta ilmoittaa onnistuneesta latauksesta päätepisteeseesi.

Salli ilmoitukset kehotettaessa. Nämä ilmoitukset raportoivat toiminnasta; ne eivät aikatauluta suoritusta.

Päätepisteen asetus

1. Valitse Automaatiotyypiksi REST API.
2. Anna URL, joka on saavutettavissa iPhonesta tai iPadista, esimerkiksi https://api.example.com/health-data.
3. Kohdassa HTTP-otsikot lisää tarvittava todennus. Käytä esimerkiksi avainta Authorization ja arvoa Bearer YOUR_TOKEN.
4. Valitse päätepisteellesi sopiva Pyynnön aikakatkaisu.

Kullakin otsikolla on oltava sekä avain että arvo. Toisen laitteen palvelimelle käytä sen saavutettavaa verkko-osoitetta localhost-osoitteen sijaan.

Tietotyyppiasetukset

Valitse tälle automaatiolle yksi Tietotyyppi: Terveysmittarit, Treenit, Oireet, ECG, Sykeilmoitukset, Mielen tila, Syklin seuranta tai Lääkkeet. Mielen tila edellyttää iOS 18:aa tai uudempaa; Lääkkeet edellyttävät iOS 26:ta tai uudempaa sekä erillistä lääkkeiden käyttöoikeutta.

Terveysmittarit

Valitse Terveysmittarit, avaa sitten Valitse terveysmittarit ja valitse tarvitsemasi mittaukset.

Rajoittaaksesi lukemat tiettyihin sovelluksiin tai laitteisiin avaa Suositellut lähteet, valitse mittari ja valitse sen lähteet. Kaikki sallii jokaisen lähteen, jota ei ole suljettu pois. Käytä Poissuljetut lähteet ohittaaksesi lähteen tämän automaation terveysmittareissa. Poissulkemiset menevät edelle; valitsematonta lähdettä ei käytetä korvikkeena, kun suositellulla lähteellä ei ole tietoja. Valitse Tallenna soveltaaksesi lähdevalinnat tai Peruuta hylätäksesi ne.

Treenit

Valitse Treenit treenitietueiden vientiin. Sisällytä reittitiedot lisää käytettävissä olevat reittipisteet JSON-treenitietoihin. Se ei luo erillisiä GPX-latauksia.

Versiolle 2 ota käyttöön Sisällytä treenimittarit lisätäksesi lukemia, kuten syke, aktiivinen energia ja askeleet. Valitse treenimittarien Aikaryhmitykseksi Minuutit tai Sekunnit; sekunnit tuottavat enemmän yksityiskohtia ja suurempia vientejä. Versio 1 sisältää aina treenimittarit.

Vientiasetukset

Vientimuoto

• JSON säilyttää rakenteelliset tiedot integraatioille ja analyysille.
• CSV luo taulukkotiedostoja taulukoille.
• Markdown luo luettavia otsikoita ja taulukoita muistiinpanoille ja arkistoille.

Vientiversio

Valitse Versio 2 nykyiseen tietorakenteeseen. Käytä Versiota 1, kun olemassa oleva työnkulku riippuu vanhemmasta muodosta.

Päivämääräväli

Valinta	Sisältyvät tiedot
Oletus	Edellinen päivä ja tämä päivä suoritusaikaan asti
Viimeisestä synkronoinnista	Edellisestä synkronoinnista suoritusaikaan
Tänään	Tämä päivä suoritusaikaan asti
Eilen	Edellinen täysi päivä
Edelliset 7 päivää	Edelliset seitsemän täyttä päivää

Tiivistä tiedot ja aikaryhmitys

JSON + Terveysmittarit -yhdistelmälle ota käyttöön Tiivistä tiedot yhdistääksesi lukemat aikaryhmiin tai poista käytöstä yksittäisille lukemille, kun ne ovat saatavilla. Tiivistys riippuu mittarista — esimerkiksi askeleet lasketaan yhteen ja painolukemat keskiarvoistetaan. CSV-terveysmittariviennit käyttävät tiivistettyjä tietoja.

Kun Aikaryhmitys on käytettävissä, valitse kuinka paljon yksityiskohtia säilytetään. Tuntiset tai päivittäiset ryhmät tuottavat vähemmän rivejä kuin minuuttiset tai sekuntiset. Käytettävissä olevat valinnat riippuvat päivämäärävälistä ja muodosta. Treenien aikaryhmitys määritetään erikseen Treenit-kohdassa.

Eräpyynnöt ja suuret payloadit

REST API + JSON -yhdistelmälle ota käyttöön Eräpyynnöt lähettääksesi tiedot useissa pyynnöissä. Käytä tätä, kun päätepisteesi hylkää suuret rungot tai suuret pyynnöt aikakatkaisevat. Vastaanottavan palvelun on käsiteltävä kukin pyyntö erikseen.

Eräjako ei ole käytettävissä CSV:lle eikä Markdownille. Se pienentää yksittäisten pyyntöjen kokoa, mutta ei vähennä terveystietojen määrää, joka laitteen on luettava. Jos valmistelu on hidasta, katso Suorituskyky.

Muistutusten aikataulutus

Jos haluat muistutuksen lukituksen avaamisesta ja sovelluksen avaamisesta, ota käyttöön Ota muistutukset käyttöön. Valitse Tunneittain, Joka päivä tai Valitut päivät, aseta sitten minuutti, aika ja päivät tarvittaessa. Salli ilmoitusten käyttöoikeus kehotettaessa; jos käyttöoikeus evätään, käytä Avaa ilmoitusasetukset.

Muistutus ei käynnistä automaatiota eikä vahvista onnistunutta synkronointia. Napauta sitä avataksesi automaation tai käytä ilmoituksen Avaa ja synkronoi -vaihtoehtoa suorituspyyntöön. Automaation on oltava käytössä; muistutus voi silti näkyä onnistuneen taustasuorituksen jälkeen. Muistutusmuutokset soveltuvat, kun tallennat.

Synkronointitiheys ja tallennus

Kohdassa Synkronointitiheys valitse määrä sekä Minuutit, Tunnit, Päivät tai Viikot — esimerkiksi 15 minuutin välein. Tämä on toivottu taustarytmi, ei taattu aikataulu.

Laitteen on oltava lukitsematta, kun terveystietoja luetaan. Ota Taustasovelluksen päivitys käyttöön Health Auto Exportille ja poista Vähävirtaustila käytöstä automaattisia suorituksia varten. iOS voi silti viivästyttää suorituksia, kun laite on ollut käyttämättömänä tai järjestelmäresurssit ovat rajoitetut.

Ota Käytössä käyttöön, kun olet valmis automaattisiin suorituksiin, valitse sitten Päivitä tallentaaksesi automaation. Voit ladata valitun päivämäärävälin heti alla olevilla vaiheilla.

Pyynnön otsikot

Sovellus asettaa Content-Type-otsikon valitulle muodolle ja sisältää:

Otsikko	Merkitys
automation-name	Automaation nimi
automation-id	Automaation tunniste
automation-aggregation	Valittu aikaryhmitys
automation-period	Valittu päivämääräväli
session-id	Pyynnön tunniste

Historiallisten tai väliin jääneiden tietojen vienti

Käytä Manuaalista latausta, kun määrität automaatiota ensimmäistä kertaa historiallisten tietojen vientiin tai myöhemmin peittääksesi päivämäärät, jotka automaattinen synkronointi ohitti. Voit myös käyttää sitä asetusten tarkistamiseen.

1. Avaa automaatio ja valitse kohdasta Vie olemassa olevat tiedot Manuaalinen lataus.
2. Aseta Aloitus- ja Lopetus-päivämäärät, valitse sitten Aloita vienti.
3. Tarkista vastaanotettu pyyntö, otsikot ja runko päätepisteessä.

Vianmääritys

• Yhtään pyyntöä ei vastaanotettu: Tarkista URL, verkkoyhteys ja palvelinlokit.
• Todennusvirhe: Tarkista otsikkoavain, token ja päätepisteen käyttöoikeudet.
• Payload hylätty tai aikakatkaistu: Tarkista palvelimen kokorajat, käytä eräjakoa JSON:lle tai pienennä viennin kokoa.

Avaa automaatio ja valitse Näytä aktiviteettilokit suoritusten tarkistamiseen. Varoitukset merkitsevät mahdollisia ongelmia, kuten hidasta tietojen hakua; virheet tunnistavat epäonnistuneet vaiheet. Ongelman ilmoittamiseen katso Apua.