Synkronoi REST API:in

REST API -automaatiot vievät terveysdatasi automaattisesti mille tahansa verkkopalvelulle, joka hyväksyy HTTP POST -pyyntöjä. Tämä sopii integraatioihin mukautettuihin taustajärjestelmiin, kolmannen osapuolen API:in tai webhookkeihin.

Yleiskatsaus

REST API -automaatiot lähettävät terveysdatasi valittuun URL-päätepisteeseen HTTP POST -pyynnöillä. Automaatio voi lähettää datan JSON- tai CSV-muodossa, ja otsikoita voi määrittää todennusta ja metatietoja varten.

Käyttötapaukset:

• Integraatio mukautettuihin taustapalveluihin
• Datan lähetys webhookkeihin
• Synkronointi kolmannen osapuolen API:in kanssa
• Mukautettujen koontinäyttöjen tai analytiikka-alustojen rakentaminen

Keskeiset ominaisuudet:

• Tukee sekä JSON- että CSV-muotoa
• Mukautetut HTTP-otsikot todennusta varten
• Säädettävä pyynnön aikakatkaisu
• Historiadatan manuaalinen vienti

Rajoitukset

• Terveysdatan käyttö: Sovellukset eivät saa käyttää terveysdataa, kun iPhone on lukittu. Automaatiot suoritetaan vain silloin, kun laite on lukitsemattomana. Tämä voi vaikuttaa datan ajantasaisuuteen. Katso ohjeet manuaaliseen synkronointiin pitääksesi datan ajan tasalla.

• Taustakäsittely: iOS rajoittaa taustakäsittelyä akun keston vuoksi. Automaatiot käyttävät taustasovellusten päivitystä (Background App Refresh) eivätkä välttämättä suoritu heti, jos:

  • Taustasovellusten päivitys on pois käytöstä sovellukselta
  • Laite on vähävirtaisessa tilassa
  • Laite on ollut pitkään passiivisena
  • Järjestelmän resurssit ovat kireät
  • Useat sovellukset kilpailevat taustasuorituksesta

Edellytykset

• Kelvollinen URL-päätepiste, joka hyväksyy HTTP POST -pyyntöjä
• Todennustiedot (jos päätepiste vaatii)
• Verkkoyhteys päätepisteeseen

Määritys

Siirry päävalikosta automaattisten vientien näyttöön, napauta Uusi automaatio ja valitse automaation tyypiksi REST API.

Automaation nimi

Anna automaatiolle kuvaava nimi (esim. ”My Backend API”, ”Webhook Integration”).

Ilmoitukset

Määritä, milloin haluat ilmoituksia:

• Notify on Cache Update – Ilmoitus, kun välimuistidata päivittyy
• Notify When Run – Ilmoitus joka kerta, kun automaatio suoritetaan

URL-määritys

Anna täydellinen URL-osoite, johon haluat lähettää terveysdatasi. Osoitteessa on oltava protokolla (http:// tai https://).

Esimerkki-URL-osoitteita:

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

Huom: URL:n on oltava kelvollinen ja laitteesi saavutettavissa. Virheelliset URL:t estävät automaation suorituksen.

Pyynnön aikakatkaisu

Valitse HTTP-pyyntöjen aikakatkaisu. Määrittää, kuinka kauan sovellus odottaa vastausta ennen kuin pyyntö katsotaan epäonnistuneeksi.

HTTP-otsikot

Lisää mukautettuja HTTP-otsikoita todennusta tai metatietoja varten. Yleisiä tapauksia:

• API-avaimet: X-API-Key: your-api-key
• Todennustokenit: Authorization: Bearer your-token
• Content-Type -ylikirjoitukset: Content-Type: application/json

Otsikoiden lisääminen:

1. Napauta Add Headers
2. Kirjoita otsikon avain vasempaan kenttään
3. Kirjoita otsikon arvo oikeaan kenttään
4. Toista tarvittaessa

Tärkeää: Jokaisella otsikkoavaimella on oltava vastaava arvo. Tyhjät otsikot ohitetaan.

Datatyypin asetukset

Datatyyppi

Valitse, minkä terveysdatan tyyppiä viedään:

• Health Metrics – Askeleet, syke, uni ja muut terveysmittaukset
• Workouts – Liikunta- ja kuntoaktiviteetit
• Symptoms – Terveysoireet ja tilat
• ECG – EKG-mittaukset
• Heart Rate Notifications – Korkea/matala syke -tapahtumat
• State of Mind – Mielialan ja mielentilan merkinnät (iOS 18.0+)
• Cycle Tracking – Kuukautiskierto ja lisääntymisterveysdata
• Medications – Lääkkeiden kirjaukset ja noudattaminen (iOS 26.0+)

Health Metrics -asetukset

Kun on valittu Health Metrics:

Select Health Metrics – Valitse, mitkä mittarit sisällytetään. Voit valita kaikki saatavilla olevat tai tiettyjä.

Vinkki: Vain tarvitsemiesi mittareiden valinta voi nopeuttaa käsittelyä ja pienentää datamäärää.

Preferred Sources – Määritä, mitkä datalähteet ovat etusijalla, kun sama mittari tulee useasta lähteestä.

Workout-asetukset

Kun on valittu Workouts:

Include Route Data – Ota käyttöön, jotta mukaan tulee reitit harjoituksille, joissa on sijaintidataa.

Include Workout Metrics – Ota käyttöön, jotta mukaan tulee harjoituksen aikana kerätyt terveysmittarit (syke, kalorit jne.).

Aikaryhmittely (harjoitusmittarit) – Kun käytössä on Export Version 2 ja Sisällytä harjoitusmittarit on päällä:

• Minutes – Ryhmittelee harjoitusmittarit minuuteittain
• Seconds – Ryhmittelee harjoitusmittarit sekunteittain

Viennin asetukset

Viennin muoto

Valitse vietävän datan muoto:

• JSON-muoto – Yksityiskohtaiset rakenteet sisäkkäisine olioineen. Paras API:lle, tietokannoille ja sovelluksille, jotka tarvitsevat rakenteisen datan. JSON sisältää enemmän yksityiskohtia monimutkaisille datatyypeille, kuten univaiheille ja AFib-lukemille.

• CSV-muoto – Taulukkomuotoinen data, jonka voi tuoda helposti taulukko-ohjelmiin. Paras yksinkertaiseen analyysiin tai kun päätepiste odottaa CSV-dataa.

Huom: Content-Type-otsikko asetetaan automaattisesti arvoon application/json JSON-vienneille ja multipart/form-data CSV-vienneille.

Viennin versio

Valitse Export Version. Versionumerointi mahdollistaa siirtymisen päivitettyihin vientimuotoihin omaan tahtiisi ja vähentää työnkulkujen rikkoutumista.

• Version 1 – Vanha muoto; käytä, jos nykyiset työnkulut riippuvat tästä
• Version 2 – Nykyinen muoto, laajennettu harjoitusdata ja yksityiskohtaisemmat metatietovaihtoehdot

Aikaväli

Valitse, milloin data viedään:

• Default – Synkronoi datan koko edelliseltä päivältä sekä kuluvaan päivään ja -aikaan asti
• Since Last Sync – Jokaisella synkronoinnilla vie kaiken datan edellisen viennin jälkeen kuluvaan päivään ja -aikaan asti
• Today – Synkronoi kaiken kuluvan päivän datan kuluvaan hetkeen asti
• Yesterday – Synkronoi koko edellisen päivän data
• Previous 7 Days – Synkronoi edellisten seitsemän päivän data

Yhteenveto datasta

Kun käytät JSON-muotoa Health Metrics -datatyypin kanssa, kytke Summarize Data päälle tai pois.

• Päällä – Tarjoaa koostetut yhteenvedot
• Poissa – Tarjoaa mahdollisuuksien mukaan erittelemätön datan, yksittäiset datapisteet näkyvissä

Huom: Tämä asetus koskee vain JSON-muotoa Health Metrics -datatyypin kanssa. Data koostetaan aina CSV-muodossa tai kun useita mittareita on valittu.

Aikaryhmittely

Kun käytät JSON-muotoa ja Summarize Data on päällä, valitse, miten data koostetaan.

Huom: CSV-muoto koostaa datan aina. Minuutti- ja sekuntitason koostaminen voi kasvattaa merkittävästi käsittelyaikaa ja datamäärää.

Eräpyynnöt (Batch Requests)

Kun käytät JSON-muotoa, kytke Batch Requests päälle lähettääksesi datan useassa pyynnössä yhden suuren kuorman sijaan.

• Päällä – Jakaa datan useisiin pyyntöihin välttääkseen liian suuret kuormat
• Poissa – Lähettää kaiken datan yhdessä pyynnössä

Synkronoinnin tiheys

Määritä, kuinka usein automaation tulisi lähettää dataa:

Valitse luku ja aikaväli.

Testaus ja varmistus

Manuaalinen testaus

1. Napauta automaation määritysnäytössä Manual Export
2. Valitse aikaväli
3. Napauta Export lähettääksesi testipyynnön
4. Tarkista päätepisteestä, että data vastaanotettiin

Toimintalokien tarkastelu

1. Napauta automaation määritysnäytössä View Activity Logs
2. Tarkista viimeisimmät automaatiosuoritukset
3. Etsi virheitä tai varoituksia
4. Varmista pyyntöjen aikaleimat ja vastauksen tila

Datan muodon tarkistus

Sovellus lisää automaattisesti nämä otsikot jokaiseen pyyntöön:

• Content-Type – Asetetaan viennin muodon mukaan
• automation-name – Automaation nimi
• automation-id – Automaation yksilöllinen tunniste
• automation-aggregation – Valittu aikaryhmittely
• automation-period – Valittu aikaväli
• session-id – Kunkin pyynnön yksilöllinen tunniste

Ongelmanratkaisu

Yleisiä ongelmia

Data ei saavu päätepisteeseen

• Varmista, että päätepisteen URL on oikein
• Tarkista, että päätepiste hyväksyy POST-pyyntöjä
• Tarkista todennusotsikot
• Tarkista päätepisteen lokit saapuvista pyynnöistä
• Varmista verkkoyhteys

Vinkkejä ja hyviä käytäntöjä

1. Automaattinen synkronointi:

   • Lataa laitetta ja käytä iPhonen peilausta (iPhone Mirroring)
     • Latauksen aikana iOS rajoittaa laitteen suorituskykyä vähemmän, jolloin data voi synkronoitua useammin
     • Peilauksella laite käyttäytyy kuin lukitsemattomana, jolloin Health Auto Export voi käyttää terveysdataa automaattisten toimintojen suorittamiseen

2. Suorituskyky:

   • Käytä sopivaa aikaryhmittelyä tasapainottaaksesi yksityiskohtia ja datamäärää
   • Valitse vain tarvitsemasi mittarit

3. Luotettavuus:

   • Aseta sopivat aikakatkaisut päätepisteen vasteajan mukaan
   • Seuraa toimintalokeja säännöllisesti

4. Datan muoto:

   • Käytä JSONia rakenteiselle datalle ja API:lle
   • Käytä CSV:tä yksinkertaiseen analyysiin tai taulukkointegraatioon
   • Harkitse eräpyyntöjä suurille aineistoille tai erilliseen käsittelyyn