La API de Oura

La API de Oura facilita el acceso a los datos generados por el anillo Oura. Para usar la API de Oura es necesario tener una cuenta de Oura y o bien un token de acceso personal o una aplicación API.

¿Qué es la API de Oura?
Cómo utilizar la API de Oura
Cómo generar tokens de acceso personal
Cómo utilizar tokens de acceso personal
Más información

¿Qué es la API de Oura?

La API de Oura puede utilizarse para obtener tus datos de Oura o crear una integración para que cualquiera pueda compartir sus datos de Oura con proveedores externos.

La versión 1 de la API de Oura se lanzó en 2016 y la versión 2 en enero de 2022. El mantenimiento de la versión 1 se discontinuó a principios de 2023.

Cómo utilizar la API de Oura

Puedes consultar toda la documentación de la versión 2 de la API de Oura aquí.

Los usuarios del anillo Oura Gen3 sin una suscripción a Oura activa ya no podrán acceder a sus datos mediante la API de Oura. Además, las aplicaciones de socios que estén integradas con la API de Oura dejarán de tener acceso a los datos de los usuarios del anillo Gen3 que no tengan una suscripción a Oura activa. Sin embargo, todos los usuarios de Oura podrán descargar sus archivos de datos desde el portal Oura on the Web. Como mínimo, estos archivos de datos estarán en cumplimiento con las directrices del RGPD.

Los usuarios de Oura deben haber actualizadola aplicación móvil de Oura para obtener acceso a los nuevos parámetros disponibles con la versión 2 de la API de Oura.

Los tokens de acceso personal existentes de la versión 1 de la API de Oura podrán seguir utilizándose con la versión 2 de la API para extraer datos personales diarios relativos a la actividad, la disposición, el sueño y la hora de acostarse. Los tokens de acceso personal existentes de la versión 1 de la API de Oura no tendrán acceso a ninguno de los nuevos parámetros disponibles con la versión 2 de la API, como la frecuencia cardíaca diurna y de entrenamiento, las etiquetas, las sesiones y otras métricas futuras. Para acceder a los nuevos parámetros que ofrece la versión 2 de la API de Oura, puedes crear nuevos tokens de acceso personal o solicitar el consentimiento de los usuarios para acceder a estos datos a través del flujo de autorización OAuth.

Los usuarios del anillo Gen2 de Oura no experimentarán ningún cambio en la disponibilidad de sus datos a través de la API de Oura.

Cómo generar tokens de acceso personal

Oura también ofrece tokens de acceso personal para facilitar la integración con la API Oura Cloud. Estos tokens de acceso personal simplifican la integración para desarrolladores que quieran extraer sus datos de Oura de forma programática de la API Oura Cloud.Actualmente no ofrecemos tokens de acceso grupales.

Para utilizar estos tokens de acceso personal, sigue estos pasos:

Dirígete a la página Tokens de acceso personal.
En la esquina superior derecha de la página, haz clic en Crear un nuevo token de acceso personal.
Introduce una nueva nota para el nuevo token de acceso personal que vas a generar.
Pulsa en Crear token de acceso personal para enviar el formulario y crear tu nuevo token de acceso personal.

Ahora debería aparecer un nuevo token de acceso en la página de tokens de acceso personal.

No olvides copiar este nuevo token, ya que no podrás verlo de nuevo una vez que hayas abandonado la página. Pulsa en Copiar para copiar el token a tu portapapeles.

Cómo utilizar tokens de acceso personal

Una vez adquirido el token de acceso personal, puedes utilizarlo para acceder a la API de Oura. Hay dos formas de ofrecer el Token de acceso personal:

Cabecera HTTP: incluye el token de acceso personal en la cabecera de seguridad así:
GET /v1/userinfo HTTP/1.1
Host: api.ouraring.com
Authorization: Bearer PHCW3OVMXQZX5FJUR6ZK4FAA2MK2CWWA
Parámetro URL: añade un parámetro access_token para la llamada de API:
https://api.ouraring.com/v1/userinfo?access_token=PHCW3OVMXQZX5FJUR6ZK4FAA2MK2CWWA

Puedes revocar tus tokens de acceso personal en cualquier momento.