Oura API를 사용하면 Oura Ring에서 생성된 데이터에 쉽게 액세스할 수 있습니다. Oura API를 사용하기 위해서는 Oura 계정과 개인 액세스 토큰 또는 API 애플리케이션이 필요합니다.
Oura API란 무엇인가요?
Oura API 사용 방법
개인 액세스 토큰 생성 방법
개인 액세스 토큰 사용 방법
추가 정보
Oura API란 무엇인가요?
Oura API를 사용하면 사용자의 Oura 데이터를 가져오거나 연동 기능 구축을 통해 누구나 자신의 Oura 데이터를 제3자 서비스와 공유할 수 있습니다.
Oura API V1은 2016년에 출시되었으며, Oura API V2는 2022년 1월에 출시되었습니다. V1에 대한 지원은 2023년 초에 중단되었습니다.
Oura API 사용 방법
Oura API V2에 대한 전체 문서는 여기에서 확인할 수 있습니다.
Oura 멤버십이 활성화되지 않은 Gen3 및 Oura Ring 4 사용자는 더 이상 Oura API를 사용하여 데이터에 액세스할 수 없습니다. 또한, Oura API와 연동된 파트너 애플리케이션 역시 Oura 멤버십이 활성화되지 않은 Gen3 및 Oura Ring 4에서는 사용자의 데이터에 액세스할 수 없습니다. 다만 모든 Oura 사용자는 멤버십 허브를 통해 자신의 데이터 파일을 계속해서 쉽게 다운로드할 수 있습니다. 이 데이터 파일은 최소한 GDPR에서 요청하는 요구사항을 준수합니다.
Oura API V2를 통해 제공되는 새로운 데이터 유형을 지원하려면 Oura 모바일 앱을 최신 버전으로 업데이트해야 합니다.
Oura API V1에서 발급된 기존 액세스 토큰은 개인 정보, 일일 활동, 일일 준비 상태, 일일 수면, 취침 시간 데이터에 한해 Oura API V2에서도 계속 사용할 수 있습니다. 다만 Oura API V1의 기존 액세스 토큰은 일간 심박수 측정, 운동시 심박수, 운동, 태그, 세션 및 향후 출시될 기타 데이터 유형과 같이 Oura API V2를 통해 제공되는 새로운 데이터 유형에는 액세스할 수 없습니다. Oura API V2에서 제공하는 새로운 데이터 유형에 액세스하려면 새로운 개인 액세스 토큰을 생성하거나 OAuth 인증 절차를 통해 사용자에게 새로운 데이터 범위에 대한 동의를 요청해야 합니다.
Oura Ring Generation 2 사용자는 Oura API를 통한 데이터 액세스에 변경사항이 없습니다.
개인 액세스 토큰 생성 방법
Oura는 Oura 클라우드 API와의 보다 간편한 연동을 위해 개인 액세스 토큰도 제공합니다. 이러한 개인 액세스 토큰을 사용하면 Oura의 클라우드 API에서 Oura 데이터를 프로그래밍 방식으로 가져오려는 개발자가 더 쉽게 연동을 구축할 수 있습니다. 현재 그룹 액세스 토큰은 제공되지 않습니다.
개인 액세스 토큰을 사용하려면 아래 단계를 따르세요.
- 개인 액세스 토큰 페이지로 이동합니다.
- 페이지 오른쪽 상단 모서리에서 “새 개인 액세스 토큰 만들기”를 클릭합니다.
- 생성하려는 새 개인 액세스 토큰에 대해 고유한 메모를 입력합니다.
- “개인 액세스 토큰 만들기”를 클릭하여 양식을 제출하고 새 개인 액세스 토큰을 생성합니다.
개인 액세스 토큰 페이지에 새 액세스 토큰이 표시됩니다.
이 페이지를 벗어나면 토큰을 다시 확인할 수 없으므로 반드시 새 토큰을 복사해 두시기 바랍니다. “복사”를 클릭하여 토큰 값을 클립보드에 복사합니다.
개인 액세스 토큰 사용 방법
개인 액세스 토큰을 발급받으면 이를 사용해 Oura API에 액세스할 수 있습니다. 개인 액세스 토큰을 전달하는 방법은 두 가지가 있습니다.
-
HTTP 헤더: 다음과 같이 인증 헤더에 개인 액세스 토큰을 포함하세요:
GET /v1/userinfo HTTP/1.1
호스트: api.ouraring.com
권한: Bearer PHCW3OVMXQZX5FJUR6ZK4FAA2MK2CWWA -
URL 매개변수: API 호출에 access_token 매개변수를 추가하세요:
https://api.ouraring.com/v1/userinfo?access_token=PHCW3OVMXQZX5FJUR6ZK4FAA2MK2CWWA
개인 액세스 토큰은 언제든지 취소할 수 있습니다.
