API Oura ułatwia dostęp do danych generowanych przez Oura Ring. Aby korzystać z API Oura, potrzebne jest konto Oura oraz jeden z poniższych: token dostępu osobistego lub Aplikacja API.
Czym jest API Oura?
Jak korzystać z API Oura
Jak wygenerować tokeny dostępu osobistego
Jak korzystać z tokenów dostępu osobistego
Więcej informacji
Czym jest API Oura?
API Oura można wykorzystać do pobrania danych Oura lub stworzenia integracji, która pozwala każdemu na udostępnianie swoich danych Oura usługom zewnętrznym.
Interfejs API V1 Oura został wprowadzony na rynek w 2016 roku, a API V2 Oura w styczniu 2022. Wsparcie dla V1 zakończyło się na początku 2023 roku.
Jak korzystać z API Oura
Pełna dokumentacja API V2 Oura jest dostępna tutaj.
Użytkownicy Gen3 i Oura Ring 4 bez aktywnego członkostwa Oura nie będą już mogli uzyskać dostępu do swoich danych za pośrednictwem API Oura. Ponadto aplikacje partnerskie zintegrowane z API Oura nie będą już miały dostępu do danych użytkowników Gen3 i Oura Ring 4, którzy nie posiadają aktywnego członkostwa Oura. Jednak wszyscy użytkownicy Oura wciąż będą w stanie z łatwością pobrać pliki zawierające ich dane za pośrednictwem Centrum członkowskiego. Powyższe pliki będą spełniać przynajmniej wymagania dotyczące wniosków wynikających z RODO.
Użytkownicy Oura są zmuszeni zaktualizować aplikację Oura do najnowszej wersji mobilnej, która jest w stanie obsługiwać nowe rodzaje danych dostępne za pośrednictwem API V2 Oura.
Istniejące tokeny dostępu z API V1 Oura pozostaną ważne do użytku w API V2 Oura w przypadku danych osobowych, dziennej aktywności, gotowości, snu i danych dotyczących pory snu. Tokeny dostępu z API V1 Oura nie będą upoważniać do wglądu w żadne nowe dane dostępne za pośrednictwem API V2 Oura, w tym pomiary tętna w ciągu dnia, tętno wysiłkowe, treningi, tagi, sesje i inne rodzaje danych, które zostaną opublikowane w przyszłości. Aby uzyskać dostęp do tych nowych danych dostarczanych przez API V2 Oura, możesz wygenerować nowe tokeny dostępu osobistego lub poprosić użytkowników o wyrażenie zgody na nowy zakres danych za pośrednictwem autoryzacji OAuth.
Użytkownicy Oura Ring Generation 2 nie doświadczą żadnych zmian w dostępności swoich danych za pośrednictwem API Oura.
Jak wygenerować tokeny dostępu osobistego
Oura oferuje również tokeny dostępu osobistego, aby ułatwić integrację z API Oura Cloud. Tokeny te ułatwiają integrację deweloperom, którzy chcą w sposób zaprogramowany pobierać swoje dane Oura z API Oura Cloud. Obecnie nie udostępniamy grupowych tokenów dostępu.
Aby rozpocząć korzystanie z tych tokenów dostępu osobistego, wykonaj poniższe czynności:
- Przejdź do strony Tokeny dostępu osobistego.
- Kliknij w „Utwórz nowy token dostępu osobistego” w prawym górnym rogu strony.
- Wprowadź niepowtarzalną notatkę dla nowego tokenu dostępu osobistego, który zamierzasz wygenerować.
- Kliknij „Utwórz token dostępu osobistego”, aby przesłać formularz i wygenerować nowy token dostępu osobistego.
Od teraz na stronie Tokeny dostępu osobistego zobaczysz na liście nowy token dostępu.
Pamiętaj, aby skopiować ten nowy token, ponieważ po opuszczeniu tej strony stracisz możliwość jego wyświetlania. Kliknij „Kopiuj”, aby skopiować wartość tokena do schowka.
Jak korzystać z tokenów dostępu osobistego
Po uzyskaniu tokenu dostępu osobistego możesz go użyć, aby zapewnić sobie dostęp do API Oura. Token dostępu osobistego można podać na dwa sposoby:
-
Nagłówek HTTP: Dołącz token dostępu osobistego do nagłówka autoryzacji w następujący sposób:
GET /v1/userinfo HTTP/1.1
Host: api.ouraring.com
Authorization: Bearer PHCW3OVMXQZX5FJUR6ZK4FAA2MK2CWWA. -
Parametr URL: Dodaj parametr access_token do wywołania API:
https://api.ouraring.com/v1/userinfo?access_token=PHCW3OVMXQZX5FJUR6ZK4FAA2MK2CWWA.
Możesz unieważnić swoje tokeny dostępu osobistego w dowolnym momencie.
