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 Oura Ring Gen3 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 s rozhraním Oura API, už také nebudou mít přístup k datům uživatelů Oura Ring Generation 3, kteří nemají aktivní členství Oura. Všichni uživatelé Oura však budou moci snadno stahovat své datové soubory prostřednictvím platformy Oura on the Web. Minimálně budou tyto datové soubory splňovat 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.
