Pour obtenir un aperçu de l'API Oura v2, veuillez consulter cet article.
L'API Oura vous permet de récupérer vos données Oura ou de mettre en place une intégration permettant à quiconque de partager ses données Oura avec un service tiers. Si vous souhaitez uniquement récupérer vos propres données, veuillez vous reporter à notre rubrique consacrée aux jetons d'accès personnels. Pour en savoir plus sur la mise en place d'une intégration par le biais d'une application API, veuillez consulter la documentation API ici.
Pour quelles raisons l'API Oura v2 a-t-elle vu le jour en lieu et place de l'API Oura v1 ?
Quelles sont les nouveautés de l'API Oura v2 ?
En quoi l'API Oura v1 et l'API Oura v2 diffèrent-elles ?
Les données sont-elles toujours accessibles via l'API Oura pour les utilisateurs de l'anneau Oura de 3e génération ne possédant plus d'Adhésion Oura ?
Combien de temps encore Oura prendra-t-elle en charge l'API v1 ?
Fournissez-vous des jetons d'accès de groupe ?
Quels projets d'amélioration prévoyez-vous pour l'API Oura ?
Proposerez-vous une fonctionnalité push ou des webhooks ?
Proposez-vous un environnement sandbox aux développeurs ne possédant pas d'anneau Oura ?
Débuter avec les jetons d'accès personnels
Utiliser votre jeton d'accès personnel
Pour quelles raisons l'API Oura v2 a-t-elle vu le jour en lieu et place de l'API Oura v1 ?
Depuis le lancement de l'API Oura v1 il y a plusieurs années, Oura a développé ses modèles de données dorsales (backend) afin de mieux refléter l'évolution du produit. L'API Oura v2 a été conçue pour assurer le rôle d'interface entre ces nouveaux modèles de données pour permettre la mise en place de nouvelles fonctionnalités et d'un plus grand nombre de critères de données.
Quelles sont les nouveautés de l'API Oura v2 ?
Notre objectif est de simplifier et de valoriser l'intégration avec Oura. Dans cette première version de l'API Oura v2, nous donnons accès à de nouveaux points de terminaison de données, absents de l'API Oura v1, y compris la mesure de la fréquence cardiaque diurne pour les anneaux de 3e génération, les données biométriques et les tendances des sessions de l'onglet "Parcourir", les tags et les séances de sport. Elle intègre également une documentation enrichie comprenant des exemples de code en ligne destinés à faciliter la prise en main de l’API Oura.
En quoi l'API Oura v1 et l'API Oura v2 diffèrent-elles ?
Cet article expose les différences entre l'API Oura v1 et l'API Oura v2.
Les données sont-elles toujours accessibles via l'API Oura pour les utilisateurs de l'anneau Oura de 3e génération ne possédant plus d'Adhésion Oura ?
Non. Les utilisateurs de l'anneau Oura de 3e génération qui ne possèdent plus d'Adhésion Oura ne pourront plus accéder à leurs données via l'API d'Oura. De même, les applications partenaires intégrées à l’API Oura n’auront plus accès aux données des utilisateurs de l’anneau Oura de 3e génération ne possédant plus d’Adhésion Oura. Néanmoins, l’ensemble des utilisateurs d’Oura auront toujours la possibilité de télécharger sans peine leurs fichiers de données via Oura on the Web, dans la rubrique Exporter des données de la page Mon compte. Ces fichiers de données seront tout au moins conformes aux exigences de demande du RGPD.
Les utilisateurs de l'anneau Oura de 2e génération ne constateront aucun changement quant à la disponibilité de leurs données via l'API Oura.
Combien de temps encore Oura prendra en charge l'API v1 ?
Il est prévu qu'Oura prenne en charge l'API v1 d'Oura pendant au moins un an à compter de la sortie de l'API v2 d'Oura en janvier 2022.
Fournissez-vous des jetons d'accès de groupe ?
Pour le moment, nous ne fournissons pas de jetons d'accès de groupe, mais nous y songeons à l'avenir. Si vous rencontrez un cas d'utilisation spécifique, veuillez nous en faire part à l'adresse api-support@ouraring.com afin que nous puissions en tenir compte dans le cadre de l'élaboration de cette future solution.
Quels projets d'amélioration prévoyez-vous pour l'API Oura ?
Nous nous perfectionnons chaque jour davantage et nous efforçons de simplifier et de valoriser l'intégration de l'API Oura. Nous poursuivrons la mise en place de nouvelles fonctionnalités et de nouvelles données, y compris de nouveaux types de données pour l’anneau Oura de 3e génération, dès que celles-ci seront disponibles (par ex. fréquence cardiaque de séance, métriques relatives à l'oxygène).
Merci de nous transmettre vos idées d'amélioration à l'adresse api-support@ouraring.com.
Proposerez-vous une fonctionnalité push ou des webhooks ?
À l'heure actuelle, les partenaires sont seulement en mesure de récupérer des données à partir de l'API Oura. Nous prévoyons d’ajouter des fonctionnalités push ainsi que des webhooks dans le courant de l’année 2022.
Proposez-vous un environnement sandbox aux développeurs ne possédant pas d'anneau Oura ?
Actuellement, nos partenaires doivent pouvoir accéder aux données d'un anneau Oura afin de tester les cas d'utilisation de l'API Oura. L'un de nos objectifs pour 2022 est d'ajouter un environnement de type "sandbox" afin que nos partenaires puissent tester les commandes avec des échantillons de données sans devoir posséder un anneau Oura.
Débuter avec les jetons d'accès personnels
Oura propose également des jetons d'accès personnels en vue de simplifier l'intégration avec l'API cloud d'Oura. Ces jetons d'accès personnels facilitent le travail d'intégration des développeurs qui cherchent à récupérer au moyen de programmes leurs données Oura à partir de l'API cloud d'Oura.
Pour commencer à utiliser ces jetons d'accès personnels, suivez les étapes ci-dessous :
- Accédez à la page Jetons d'accès personnels.
- Dans le coin supérieur droit de la page, cliquez sur le bouton "Créer un nouveau jeton d'accès personnel
- Saisissez une mention spéciale pour le nouveau jeton d'accès personnel que vous êtes sur le point de créer
- Cliquez sur "Créer un jeton d'accès personnel pour valider le formulaire et créer votre nouveau jeton d'accès personnel.
Vous devriez à présent disposer d'un nouveau jeton d'accès listé sur la page Jetons d'accès personnels.
Veillez à recopier ce nouveau jeton, car vous ne pourrez plus l'afficher après avoir quitté cette page. Cliquez sur "Copier pour recopier la valeur du jeton dans votre presse-papiers.
Utiliser votre jeton d'accès personnel
Une fois que vous disposerez de votre jeton d'accès personnel, vous pourrez l'utiliser pour accéder à l'API d'Oura. Vous avez deux possibilités pour renseigner votre jeton d'accès personnel :
- En-tête HTTP : Intégrez le jeton d'accès personnel dans l'en-tête d'autorisation comme ceci :
GET /v1/userinfo HTTP/1.1
Host: api.ouraring.com
Authorization: Bearer PHCW3OVMXQZX5FJUR6ZK4FAA2MK2CWWA - Paramètre URL : Ajoutez le paramètre access_token à l'appel API :
https://api.ouraring.com/v1/userinfo?access_token=PHCW3OVMXQZX5FJUR6ZK4FAA2MK2CWWA
Vous pouvez révoquer vos jetons d'accès personnels à tout moment.
Vous avez d'autres questions ? Alors, contactez-nous à l'adresse api-support@ouraring.com.
