Para informarte sobre la versión 2 de la API de Oura, consulta este artículo.
La API de Oura puede utilizarse para obtener tus datos de Oura o crear una integración que permita a cualquier persona compartir sus datos de Oura con un servicio externo. Si solo deseas extraer tus datos, lee la sección sobre los tokens de acceso personales. Para saber más sobre cómo crear una integración empleando una aplicación API, consulta la documentación de la API aquí.
¿Por qué se ha lanzado una versión 2 de la API de Oura en lugar de mejorar la versión 1 de la API?
¿Qué novedades incluye la versión 2 de la API de Oura?
¿En qué se diferencian la v1 y la v2 de la API de Oura?
¿Siguen siendo accesibles los datos a través de la API de Oura para usuarios del anillo Gen3 de Oura que ya no tengan una suscripción a Oura?
¿Por cuánto tiempo seguirá manteniendo Oura la v1 de la API?
¿Ofrecéis tokens de acceso grupales?
¿Qué futuras mejoras se prevén para la API de Oura?
¿Tenéis pensado ofrecer la funcionalidad Push o webhooks?
¿Ofrecéis un entorno de pruebas para aquellos desarrolladores que no tengan un anillo Oura?
Tokens de acceso personal
Cómo utilizar tu Token de acceso personal
¿Por qué se ha lanzado una versión 2 de la API de Oura en lugar de mejorar la versión 1 de la API?
Desde el lanzamiento de la v1 de la API de Oura hace varios años, Oura ha modificado los modelos de datos de su backend para reflejar la evolución del producto. La v2 de la API de Oura se ha diseñado en línea con estos modelos de datos, lo cual permitirá nuevas funcionalidades y más parámetros de datos.
¿Qué novedades incluye la versión 2 de la API de Oura?
El objetivo es hacer que el anillo Oura sea el dispositivo wearable más valioso y fácil de integrar. En este primer lanzamiento de la v2 de la API de Oura, ofrecemos acceso a nuevos parámetros que no existían en la v1 de la API, como la medición de frecuencia cardíaca diurna para los anillos Gen3, datos de tendencias biométricos de las sesiones de la pantalla Contenidos, etiquetas y entrenamientos. También trae una documentación mejorada que incluye ejemplos de código incrustado para poner las cosas más fáciles a quienes quieran empezar a utilizar la API de Oura.
¿En qué se diferencian la v1 y la v2 de la API de Oura?
Este artículo resume las diferencias entre la v1 y la v2 de la API de Oura.
¿Siguen siendo accesibles los datos a través de la API de Oura para usuarios del anillo Gen3 de Oura que ya no tengan una suscripción a Oura?
No, los usuarios del anillo Gen3 que ya no tengan una suscripción a Oura dejarán de tener acceso a sus datos a través de 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 ya no tengan una suscripción a Oura. Sin embargo, todos los usuarios de Oura podrán descargarse sus datos fácilmente en la plataforma Oura on the Web, desde la sección Export Data (Exportar datos) de la página My Account (Mi cuenta). Como mínimo, estos archivos de datos estarán en cumplimiento con las directrices del RGPD.
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.
¿Por cuánto tiempo seguirá manteniendo Oura la v1 de la API?
Oura seguirá manteniendo la versión 1 de la API de Oura durante al menos un año tras el lanzamiento de la versión 2 de la API en enero de 2022.
¿Ofrecéis tokens de acceso grupales?
De momento no ofrecemos tokens de acceso grupales, pero estamos considerándolo para el futuro. Si tienes un ejemplo de uso específico, envíanoslo a api-support@ouraring.com para que podamos tenerlo en cuenta al desarrollar esta opción.
¿Qué futuras mejoras se prevén para la API de Oura?
Nos esforzamos constantemente por mejorar para hacer que el anillo Oura sea el dispositivo wearable más valioso y fácil de integrar. Continuaremos introduciendo nuevas funciones y datos, incluyendo nuevos parámetros para el anillo Gen3 de Oura a medida que estén disponibles (e.g. FC de entrenamiento y métricas relativas al oxígeno).
Puedes enviar sugerencias de mejoras a api-support@ouraring.com.
¿Tenéis pensado ofrecer la funcionalidad Push o webhooks?
Actualmente, nuestros socios solo pueden obtener datos de la API de Oura. En 2022, tenemos pensado introducir la funcionalidad Push y ofrecer webhooks.
¿Ofrecéis un entorno de pruebas para aquellos desarrolladores que no tengan un anillo Oura?
Actualmente, nuestros socios necesitan tener acceso a los datos de un anillo Oura para realizar pruebas de uso en la API de Oura. En 2022, tenemos pensado añadir un entorno de pruebas para que los socios puedan probar comandos con datos de muestra sin necesidad de tener un anillo Oura.
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 hacen la integración más sencilla para desarrolladores que quieran extraer sus datos de Oura de forma programática de la API Oura Cloud.
Para utilizar estos tokens de acceso personal, sigue estos pasos:
- Dirígete a la página de 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 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 tu Token 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.
Si tienes preguntas relacionadas con las aplicaciones de la API de Oura, contacta con nosotros en api-support@ouraring.com.
