Oura API V2 -päivitysopas

Tässä artikkelissa kerrotaan, miten voit päivittää Oura API V1 -integraatiosi toimimaan Oura API V2:n kanssa. Oura säilyttää Oura API V1:n toiminnassa vähintään vuoden 2023 alkuun asti. Suosittelemme päivittämään integraation vuoden 2022 aikana.

Tietojen käyttö

Olemassa olevat käyttöoikeustunnukset

Oura API V1:n olemassa olevia käyttöoikeustunnuksia voi käyttää myös 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.

Uudet tietoalueet

Uusia tietoalueita ovat syke, treenit, tunnisteet ja harjoitukset. Voit pyytää käyttäjiä sallimaan näiden alueiden käytön Oura-käyttäjän valtuutusprosessin aikana. Lisätietoja on dokumentaatiossa.

Käyttöoikeustunnus kyselyparametrina

Parantaaksemme Oura APIn tietoturvaa olemme poistaneet mahdollisuuden käyttää käyttöoikeustunnuksia kyselyparametrina Oura API V2:ssa. Käyttöoikeustunnukset on sisällytettävä valtuutuspyynnön otsikkoon. Lisätietoja on Oura API V2 -dokumentaation valtuutusosiossa.

Virhekoodi 426

Saatat saada virhekoodin 426, kun käytät Oura API V2:ta. Tämä virhe johtuu siitä, että Oura-käyttäjän Oura-mobiilisovelluksen versio ei täytä minimiversiovaatimusta pyydetyn tietotyypin jakamiselle. Oura-käyttäjän on päivitettävä Oura-mobiilisovelluksensa, jotta Oura API V2 voi käyttää pyydettyä tietotyyppiä. Odotamme 426-vastausten vähentyvän ja lopulta loppuvan kokonaan, kun saamme päivitettyä taustajärjestelmän kokonaisuudessaan.