Ouran ohjelmointirajapinnan (API) avulla on helppo hyödyntää Oura-sormuksen tuottamia tietoja. Oura APIn käyttäminen edellyttää Oura-tiliä ja joko henkilökohtaista käyttöoikeustunnusta tai API-sovellusta.
Mikä on Oura API?
Näin käytät Oura APIa
Näin luot henkilökohtaisia käyttöoikeustunnuksia
Näin käytät henkilökohtaisia käyttöoikeustunnuksia
Lisätietoja
Mikä on Oura API?
Oura APIn avulla voit noutaa Oura-tietojasi tai luoda sovellusintegraation, jonka avulla kuka tahansa voi jakaa Oura-tietonsa kolmannen osapuolen palvelulle.
Oura APIn ensimmäinen versio (v1) julkaistiin vuonna 2016 ja Oura APIn toinen versio (v2) tammikuussa 2022. Ensimmäisen version tuki lopetettiin vuoden 2023 alussa.
Näin käytät Oura APIa
Oura API v2:n dokumentaatio on saatavissa täältä.
Kolmannen sukupolven sormuksen käyttäjät, joilla ei ole aktiivista Oura-jäsenyyttä, eivät voi enää hakea tietojaan Oura APIn kautta. Myöskään kumppanisovellukset, jotka on integroitu Oura APIn kautta, eivät voi hakea sellaisten kolmannen sukupolven Oura-sormuksen käyttäjien tietoja, joiden Oura-jäsenyys ei ole voimassa. Kaikki Oura-käyttäjät voivat kuitenkin yhä ladata tietonsa Oura on the Webistä. Nämä tiedot täyttävät vähintään GDPR-tietopyyntövaatimukset.
Oura-käyttäjillä täytyy olla Oura-mobiilisovelluksen uusin versio, joka tukee Oura API v2:n kautta saatavilla olevia uusia tietotyyppejä.
Oura API v1:n olemassa olevia käyttöoikeustunnuksia voi edelleen käyttää Oura API v2:n kanssa henkilötietojen ja päivittäisten aktiivisuus-, valmius-, uni- ja nukkumaanmenoaikatietojen noutamiseen. Oura API V1:n käyttöoikeustunnuksilla ei ole kuitenkaan pääsyä Oura API V2:n kautta tarjottaviin uusiin tietotyyppeihin, joita ovat esimerkiksi päiväaikainen syke, treenisyke, treenit, tunnisteet ja harjoitukset, eikä muihin tulevaisuudessa julkaistaviin tietotyyppeihin. Jos haluat pääsyn Oura API V2:n uusiin tietotyyppeihin, luo uudet henkilökohtaiset käyttöoikeustunnukset tai pyydä käyttäjiä sallimaan uudet tietoalueet OAuth-valtuutuskulun kautta.
Toisen sukupolven Oura-sormuksen käyttäjien tietojen saatavuuteen Oura APIn kautta ei tule muutoksia.
Näin luot henkilökohtaisia käyttöoikeustunnuksia
Ouran tarjoamat henkilökohtaiset käyttöoikeustunnukset ovat helppo tapa käyttää Oura Cloud APIa. Henkilökohtaisten tunnusten avulla kehittäjien on helppo noutaa Oura-tietonsa ohjelmallisesti Ouran Cloud APIn kautta. Emme toistaiseksi tarjoa ryhmäkäyttöoikeustunnuksia.
Voit aloittaa henkilökohtaisten käyttöoikeustunnusten käytön seuraavasti:
- Siirry Personal Access Tokens -sivulle.
- Valitse sivun oikeasta yläkulmasta Create A New Personal Access Token.
- Kirjoita uudelle henkilökohtaiselle käyttöoikeustunnukselle yksilöllinen kuvaus.
- Lähetä lomake Create Personal Access Token -painikkeella, jolloin sinulle luodaan uusi henkilökohtainen käyttöoikeustunnus.
Uusi tunnuksesi näkyy sen luomisen jälkeen Personal Access Tokens -sivulla.
Muista kopioida tunnus heti talteen, sillä tältä sivulta poistuttuasi et näe sitä enää mistään. Voit kopioida tunnuksen leikepöydälle valitsemalla Copy.
Näin käytät henkilökohtaisia käyttöoikeustunnuksia
Kun olet saanut henkilökohtaisen käyttöoikeustunnuksesi, voit käyttää sen avulla Oura APIa. Tunnusta voi käyttää kahdella tavalla:
-
HTTP-otsikko – lisää henkilökohtainen käyttöoikeustunnuksesi valtuutusotsikkoon seuraavasti:
GET /v1/userinfo HTTP/1.1
Host: api.ouraring.com
Authorization: Bearer PHCW3OVMXQZX5FJUR6ZK4FAA2MK2CWWA -
URL-parametri – lisää access_token-parametri API-kutsuun:
https://api.ouraring.com/v1/userinfo?access_token=PHCW3OVMXQZX5FJUR6ZK4FAA2MK2CWWA
Voit poistaa henkilökohtaiset käyttöoikeustunnuksesi käytöstä milloin tahansa.
