L'API Google Health utilise un framework robuste et standardisé pour gérer l'accès aux données utilisateur et leur sécurité. Un élément central de cette modernisation est la transition de l'ancienne autorisation Fitbit (FOT) vers Google OAuth 2.0. Ce changement permet aux développeurs d'exploiter les bibliothèques d'authentification Google standards, ce qui simplifie l'implémentation tout en offrant aux utilisateurs une interface familière et centralisée pour gérer leurs autorisations.
Enregistrement de l'application
Toutes les applications de l'API Google Health doivent être enregistrées à l'aide de la console Google Cloud, qui sert de hub central pour gérer toutes vos applications Google.
Pour savoir comment enregistrer votre application, suivez la procédure décrite dans Premiers pas. Voici les différences que vous remarquerez lors de l'enregistrement de vos applications.
| API Web Fitbit | API Google Health | |
| Lien(s) public(s) | https://dev.fitbit.com/apps | https://console.cloud.google.com |
| Ajouter une application | Appuyez sur Enregistrer une nouvelle application. |
|
| Informations générales | Champs à remplir :
|
Champs à remplir :
|
| Types d'applications | Un développeur doit sélectionner :
|
|
| ID client | Enregistré lorsque les paramètres de l'application sont enregistrés | Enregistré séparément |
| Type d'accès | L'accès en lecture et en écriture est contrôlé au niveau de l'application. | L'accès en lecture et en écriture est contrôlé au niveau du champ d'application. |
| URL supplémentaires |
|
|
Implémentation d'OAuth
Les applications de l'API Google Health ne sont compatibles qu'avec les bibliothèques clientes Google OAuth2. Des bibliothèques clientes sont disponibles pour les frameworks courants, ce qui simplifie l'implémentation d'OAuth 2.0.
Les différences entre les bibliothèques Google OAuth2 et les bibliothèques OAuth2 Open Source sont les suivantes :
| API Web Fitbit | API Google Health | |
| Compatibilité avec la bibliothèque OAuth2 | Open Source | Bibliothèques clientes Google OAuth2 |
| Fonctionnalité | Incohérence entre les plates-formes | Cohérence entre les plates-formes |
| URL d'autorisation | https://www.fitbit.com/oauth2/authorize | https://accounts.google.com/o/oauth2/v2/auth |
| URL du jeton | https://api.fitbit.com/oauth2/token | https://oauth2.googleapis.com/token |
| Durée de vie du jeton d'accès | 8 heures | 1 heure |
| Taille du jeton d'accès | 1 024 octets | 2 048 octets |
| Jeton d'actualisation | Les jetons d'actualisation sont générés lors de l'utilisation du flux d'attribution de code d'autorisation. Un seul jeton d'actualisation peut être généré pour un utilisateur. Les jetons n'expirent jamais et ne peuvent être utilisés qu'une seule fois. | Pour générer un jeton d'actualisation, la chaîne d'autorisation doit contenir le paramètre de requête "access_type=offline". Plusieurs jetons d'actualisation peuvent être créés pour un même utilisateur. Les jetons d'actualisation peuvent être basés sur le temps. Ils expireront s'ils n'ont pas été utilisés pendant six mois, si l'utilisateur a accordé un accès limité dans le temps ou si l'application est en mode "Test". Pour en savoir plus, consultez Expiration du jeton d'actualisation. |
| Réponse du jeton | La réponse JSON contient :
|
La réponse JSON contient :
Pour obtenir l'ID utilisateur, appelez le point de terminaison users.getIdentity une fois qu'au moins un champ d'application Google Health est accordé, et gardez les anciens jetons Fitbit actifs jusqu'à ce que legacyUserId soit validé.
|
Réauthentification de l'utilisateur (réacceptation obligatoire)
Les utilisateurs de Fitbit doivent donner à nouveau leur consentement pour votre nouvelle intégration, car votre application utilise une bibliothèque OAuth différente. Il n'est pas possible de transférer des jetons d'accès et d'actualisation vers l'API Google Health pour qu'ils fonctionnent.
Chaque utilisateur qui donne à nouveau son consentement est comptabilisé dans la limite de débit d'attribution de jetons OAuth de votre projet Google Cloud. Google Cloud applique une limite de débit aux attributions de jetons OAuth pour contrôler la vitesse à laquelle votre application peut intégrer ou réauthentifier les utilisateurs. Si vous prévoyez de dépasser 10 000 inscriptions ou réauthentifications d'utilisateurs sur une période glissante de 24 heures, demandez un quota plus élevé à l'avance. Pour en savoir plus, consultez Limites de débit des applications OAuth.