Oura API umožňuje snadný přístup k datům generovaným prstenem Oura Ring. Chcete-li používat rozhraní Oura API, potřebujete účet Oura a buď token PAT, nebo aplikaci API.
Co je Oura API?
Jak používat Oura API?
Jak generovat tokeny PAT?
Jak používat tokeny PAT?
Další informace
Co je Oura API?
Rozhraní Oura API lze použít k načtení vašich dat Oura nebo k vytvoření integrace, která umožní komukoli sdílet svá data Oura se službou třetí strany.
Oura API V1 byla vydána v roce 2016 a Oura API V2 byla vydána v lednu 2022. Podpora pro V1 byla ukončena počátkem roku 2023.
Jak používat Oura API?
Kompletní dokumentaci k Oura API V2 najdete zde.
Uživatelé s prstenem Gen3 a Oura Ring 4 bez aktivního členství Oura už nebudou mít přístup ke svým datům prostřednictvím rozhraní Oura API. Partnerské aplikace, které jsou integrovány do rozhraní Oura API, už také nebudou mít přístup k datům uživatelů Gen 3 a Oura Ring 4, kteří nemají aktivní členství Oura. Všichni uživatelé Oura si ale budou moci snadno stahovat datové soubory prostřednictvím členské sekce. Tyto datové soubory budou splňovat minimálně požadavky GDPR.
Uživatelé Oura musí mít aktualizovanou poslední verzi mobilní aplikace Oura, která podporuje nové datové typy dostupné prostřednictvím rozhraní Oura API V2.
Stávající přístupové tokeny z rozhraní Oura API V1 zůstanou platné pro použití s rozhraním Oura API V2 pro osobní údaje, denní aktivitu, denní připravenost, denní spánek a údaje o čase večerky. Stávající přístupové tokeny z rozhraní Oura API V1 nebudou mít přístup k žádným novým datovým typům dostupným prostřednictvím rozhraní Oura API V2, včetně měření denní tepové frekvence, tepové frekvence při zátěži, tréninků, štítků, relací a dalších datových typů, které budou vydány v budoucnu. Pro přístup k novým datovým typům poskytovaným rozhraním Oura API V2 můžete buď vytvořit nové tokeny PAT, nebo požádat uživatele o souhlas s novými datovými rozsahy prostřednictvím autorizačního toku OAuth.
Uživatelé s prstenem Oura Ring Generation 2 nepocítí žádné změny dostupnosti svých dat prostřednictvím Oura API.
Jak generovat tokeny PAT?
Oura také nabízí tokeny PAT pro snadnější integraci s Oura Cloud API. Tyto tokeny PAT usnadňují integraci vývojářům, kteří chtějí programově získávat svá data Oura z Oura Cloud API. V současné době neposkytujeme skupinové přístupové tokeny.
Chcete-li začít používat tyto tokeny PAT, postupujte podle následujících kroků:
- Přejděte na stránku Tokeny PAT.
- V pravém horním rohu stránky klikněte na „Vytvořit nový token PAT“.
- Zadejte jedinečnou poznámku pro nový token PAT, který se chystáte vygenerovat.
- Klikněte na „Vytvořit token PAT“ pro odeslání formuláře a vytvoření nového tokenu PAT.
Nyní byste měli mít nový přístupový token uvedený na stránce Tokeny PAT.
Tento nový token nezapomeňte zkopírovat, protože jakmile z této stránky odejdete, nebudete moci token zobrazit. Klikněte na „Kopírovat“ pro zkopírování hodnoty tokenu do schránky.
Jak používat tokeny PAT?
Jakmile získáte svůj token PAT, můžete jej použít pro přístup k rozhraní Oura API. Token PAT lze poskytnout dvěma způsoby:
-
HTTP hlavička: Zahrňte token PAT do autorizační hlavičky následovně:
GET /v1/userinfo HTTP/1.1
Hostitel: api.ouraring.com
Autorizace: Bearer PHCW3OVMXQZX5FJUR6ZK4FAA2MK2CWWA -
URL parametr: Přidejte parametr access_token do volání API:
https://api.ouraring.com/v1/userinfo?access_token=PHCW3OVMXQZX5FJUR6ZK4FAA2MK2CWWA
Své tokeny PAT můžete kdykoli odvolat.
