A API Oura facilita o acesso aos dados gerados pelo Oura Ring. Para a usar, precisas de ter uma conta Oura e um Token de acesso pessoal ou de uma aplicação API.
O que é a API Oura?
Como usar a API Oura
Como gerar Tokens de acesso pessoal
Como usar Tokens de acesso pessoal
Mais informações
O que é a API Oura?
A API Oura pode ser usada para aceder aos teus dados Oura ou criar uma integração que permite que qualquer pessoa partilhar os seus dados Oura com um serviço de terceiros.
A API Oura V1 foi lançada em 2016 e a API Oura V2 foi lançada em janeiro de 2022. O suporte à V1 foi descontinuado no início de 2023.
Como usar a API Oura
A documentação completa da API Oura V2 pode ser encontrada aqui.
Os utilizadores do Gen3 e do Oura Ring 4 sem Subscrição Oura ativadeixarão de conseguir aceder aos seus dados através da API Oura. Além disso, as aplicações parceiras integradas com a API Oura também não terão acesso aos dados destes utilizadores do Gen3 e do Oura Ring 4 sem Subscrição ativa. No entanto, todos os utilizadores Oura poderão descarregar os seus ficheiros de dados facilmente através do Centro de membros. Pelo menos, estes ficheiros cumprirão os requisitos de pedidos do GDPR.
Os utilizadores Oura devem ter atualizado para uma versão recente da aplicação Oura para suportar os novos tipos de dados disponíveis através da API Oura V2.
Os tokens de acesso existentes da API Oura V1 continuarão válidos para usar na API Oura V2 com informações pessoais, atividade diária, preparação diária, sono diário e dados de hora de deitar. No entanto, os tokens de acesso existentes da API Oura V1 não terão acesso aos novos tipos de dados disponíveis na API Oura V2, como frequência cardíaca diurna, frequência cardíaca de treino, treinos, etiquetas, sessões e outros dados que serão lançados no futuro. Para aceder a estes novos tipos de dados fornecidos pela API Oura V2, podes criar novos tokens de acesso pessoal ou pedir aos utilizadores que consintam novos escopos de dados através do fluxo de autorização OAuth.
Os utilizadores do Oura Ring Generation 2 não terão alterações na disponibilidade dos seus dados através da API Oura.
Como gerar Tokens de acesso pessoal
A Oura também oferece tokens de acesso pessoal para facilitar a integração com a API Oura Cloud. Estes tokens tornam mais fácil para os programadores acederem programaticamente aos seus dados Oura a partir da API Cloud Oura. Atualmente, não fornecemos tokens de acesso em grupo.
Para começares a usar estes tokens de acesso pessoal, segue os passos abaixo:
- Vai até à página de Tokens de acesso pessoal
- No canto superior direito da página, clica em "Criar um novo token de acesso pessoal"
- Introduz uma nota única para o novo Token de acesso pessoal que vais gerar
- Clica em "Criar token de acesso pessoal" para enviar o formulário e criar o teu novo token de acesso pessoal
Agora deves ver o teu novo token de acesso listado na página de Tokens de acesso pessoal.
Certifica-te de copiar este novo token, pois não poderás vê-lo novamente depois de saíres desta página. Clica em “Copiar” para copiar o valor do token para a tua área de transferência.
Como usar Tokens de acesso pessoal
Depois de obteres o teu token de acesso pessoal, este pode ser usado para aceder à API Oura. Existem duas formas de fornecer o token:
-
Cabeçalho HTTP: inclui o token de acesso pessoal no cabeçalho de autorização assim:
GET /v1/userinfo HTTP/1.1
Host: api.ouraring.com
Authorization: Bearer PHCW3OVMXQZX5FJUR6ZK4FAA2MK2CWWA -
Parâmetro de URL: adiciona o parâmetro access_token à chamada da API:
https://api.ouraring.com/v1/userinfo?access_token=PHCW3OVMXQZX5FJUR6ZK4FAA2MK2CWWA
Podes revogar os teus tokens de acesso pessoal a qualquer momento.
