L'API Oura facilite l'accès aux données générées par l'anneau Oura. Pour utiliser l'API OURA, vous devez avoir un compte Oura et un jeton d'accès personnel ou une application API.
En quoi consiste l'API Oura ?
Comment utiliser l'API Oura ?
Comment générer des jetons d'accès personnels ?
Comment utiliser les jetons d'accès personnels ?
En savoir plus
En quoi consiste l'API Oura ?
L'API Oura permet de récupérer vos données Oura ou de concevoir une intégration permettant à tout un chacun de partager ses données Oura avec un service tiers.
L'API Oura V1 a été publiée en 2016 et l'API Oura V2 en janvier 2022. La V1 n'est plus prise en charge depuis le début de l'année 2023.
Comment utiliser l'API Oura ?
Vous pouvez consulter ici la documentation complète sur l'API Oura V2..
Les personnes disposant d'un anneau de 3e génération sans abonnement Oura actif ne pourront plus accéder à leurs données via l'API Oura. De même, les applications partenaires intégrées à l'API Oura n'auront plus accès aux données des utilisateurs/trices de l'anneau Oura de 3e génération ne disposant pas d'un abonnement Oura actif. Toutefois, toutes les personnes utilisant Oura pourront toujours télécharger leurs fichiers de données facilement via Oura on the Web. Ces fichiers de données seront, au minimum, conformes aux exigences du RGPD.
Les utilisateurs/trices d'Oura doivent avoir téléchargé et installé une version récente de l'application mobile Oura pour pouvoir utiliser les nouveaux types de données disponibles via l'API Oura V2.
Les jetons d'accès existants de l'API Oura V1 pourront être utilisés avec l'API Oura V2 pour les informations personnelles, l'activité quotidienne, le niveau de préparation quotidien, le temps de sommeil quotidien et les données relatives à l'heure de coucher. Les jetons d'accès existants de l'API Oura V1 n'auront pas accès aux nouveaux types de données disponibles via l'API Oura V2, comme la fréquence cardiaque diurne, la fréquence cardiaque pendant les séances de sport, les séances de sport, les tags, les sessions et les autres types de données qui seront publiés à l'avenir. Pour accéder à de nouveaux types de données fournis par l'API Oura V2, vous pouvez soit créer de nouveaux jetons d'accès personnels, soit demander aux utilisateurs/trices d'accepter de nouveaux niveaux d'accès aux données via le flux d'autorisation OAuth.
Les utilisateurs/trices de l'anneau Oura de 2e génération ne constateront aucun changement quant à la disponibilité de leurs données via l'API Oura.
Comment générer des 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 Oura. Ces jetons d'accès personnels facilitent le travail d'intégration des développeurs qui cherchent à récupérer par programmation leurs données Oura à partir de l'API cloud Oura. Nous ne fournissons pas actuellement de jetons d'accès de groupe.
Pour commencer à utiliser ces jetons d'accès personnels, procédez comme suit :
- Ouvrez la page Jetons d'accès personnels.
- En haut à droite de la page, cliquez sur "Créer un jeton d'accès personnel".
- Saisissez une mention spéciale pour le jeton d'accès personnel que vous allez créer.
- Cliquez sur "Créer un jeton d'accès personnel" pour valider le formulaire et créer votre jeton d'accès personnel.
Vous devriez à présent disposer d'un nouveau jeton d'accès, et celui-ci devrait figurer sur la page "Jetons d'accès personnels".
Veillez à copier ce nouveau jeton, car vous ne pourrez plus l'afficher après avoir quitté cette page. Cliquez sur "Copier" pour copier la valeur du jeton dans votre presse-papiers.
Comment utiliser les jetons d'accès personnels ?
Une fois que vous disposez de votre jeton d'accès personnel, vous pouvez l'utiliser pour accéder à l'API Oura. Vous avez deux possibilités pour renseigner votre jeton d'accès personnel :
- En-tête HTTP : ajoutez le jeton d'accès personnel dans l'en-tête d'autorisation comme suit :
GET /v1/userinfo HTTP/1.1
Hôte : api.ouraring.com
Autorisation : Bearer PHCW3OVMXQZX5FJUR6ZK4FAA2MK2CWWA - Paramètre d'URL : ajoutez le paramètre access_token à l'appel d'API :
https://api.ouraring.com/v1/userinfo?access_token=PHCW3OVMXQZX5FJUR6ZK4FAA2MK2CWWA
Vous pouvez révoquer vos jetons d'accès personnels à tout moment.
En savoir plus
Documentation sur l'API Oura V2
Documentation sur l'API Oura V1
