Az Oura API megkönnyíti az Oura Ring gyűrű által generált adatok elérését. Az Oura API használatához Oura-fiókra és személyes hozzáférési tokenre vagy API- alkalmazásra van szükséged.
Mi az Oura API?
Az Oura API használata
Személyes hozzáférési tokenek létrehozása
Személyes hozzáférési tokenek használata
További információk
Mi az Oura API?
Az Oura API segítségével kérhetők le az Oura-adatok vagy hozható létre olyan integráció, amely bárki számára lehetővé teszi, hogy megoszthassa az Oura-adatait egy harmadik fél szolgáltatásával.
Az Oura API V1 2016-ban, az Oura API V2 pedig 2022 januárjában jelent meg. A V1 támogatása 2023 elején megszűnt.
Az Oura API használata
Az Oura API V2 teljes dokumentációját itt találod.
Az aktív Oura-tagság nélküli Gen3 és Oura Ring 4 felhasználók már nem férhetnek hozzá adataikhoz az Oura API-n keresztül. Továbbá az Oura API-val integrált partneralkalmazások már nem férnek hozzá az olyan Gen3 és Oura Ring 4 felhasználók adataihoz, akik nem rendelkeznek aktív Oura-tagsággal. Ugyanakkor minden Oura-felhasználó továbbra is könnyedén letöltheti adatfájljait a Tagi portálról. Ezeknek az adatfájloknak meg kell felelniük legalább a GDPR lekérési követelményeinek.
Az Oura-felhasználóknak frissíteniük kell az Oura mobilalkalmazás legújabb verziójára az Oura API V2-n keresztül elérhető új adattípusok támogatása érdekében.
Az Oura API V1 meglévő hozzáférési tokenjei továbbra is érvényesek az Oura API V2 használatához a személyes adatok, a napi aktivitások, a napi készenlét, a napi alvás és a lefekvési adatok vonatkozásában. Az Oura API V1 meglévő hozzáférési tokenjei nem biztosítanak hozzáférést az Oura API V2-en keresztül elérhető új adattípusokhoz, beleértve a nappali pulzust, az edzési pulzusszámot, az edzéseket, a címkéket, a meditációkat és más, a jövőben megjelenő adattípusokat. Az Oura API V2 által biztosított új adattípusokhoz való hozzáféréshez vagy új személyes hozzáférési tokeneket hozhatsz létre, vagy kérheted a felhasználókat, hogy járuljanak hozzá az új adatokhoz az OAuth engedélyezési folyamat révén.
Az Oura Ring Generation 2 felhasználók nem tapasztalnak változást az adataik Oura API-n keresztül való elérhetőségében.
Személyes hozzáférési tokenek létrehozása
Az Oura személyes hozzáférési tokeneket is kínál az Oura Cloud API-val való könnyebb integráció érdekében. Ezek a személyes hozzáférési tokenek megkönnyítik az integrációt az olyan fejlesztők számára, akik automatizáltan szeretnék letölteni az Oura-adataikat az Oura Cloud API-jából. Jelenleg nem biztosítunk csoportos hozzáférési tokeneket.
A személyes hozzáférési tokenek használatának megkezdéséhez kövesd az alábbi lépéseket:
- Keresd meg a Személyes hozzáférési tokenek oldalt.
- Az oldal jobb felső sarkában kattints az Új személyes hozzáférési token létrehozása lehetőségre.
- Adj hozzá egy egyedi megjegyzést az új, létrehozni kívánt személyes hozzáférési tokenhez.
- Kattints a Személyes hozzáférési token létrehozás lehetőségre az űrlap elküldéséhez és az új személyes hozzáférési token létrehozásához.
Az új hozzáférési tokened most már szerepel a Személyes hozzáférési tokenek oldalon.
Feltétlenül másold ki ezt az új tokent, mivel nem fogod tudni többé megtekinteni, miután elnavigáltál erről az oldalról. A token vágólapra történő másolásához kattints a Másolás gombra.
Személyes hozzáférési tokenek használata
Miután létrehoztad a személyes hozzáférési tokenedet, felhasználhatod az Oura API elérésére. A Személyes hozzáférési token kétféle módon adható meg:
-
HTTP fejléc: másold be a személyes hozzáférési tokent az engedélyezési fejlécbe az alábbi formában:
GET /v1/userinfo HTTP/1.1
Host: api.ouraring.com
Authorization: Bearer PHCW3OVMXQZX5FJUR6ZK4FAA2MK2CWWA -
URL paraméter: Access_token paraméter hozzáadása az API-híváshoz:
https://api.ouraring.com/v1/userinfo?access_token=PHCW3OVMXQZX5FJUR6ZK4FAA2MK2CWWA
Személyes hozzáférési tokenjeidet bármikor visszavonhatod.
