Présentation de l'autorisation

L'API Nest fournit des informations que vous pouvez utiliser pour créer des expériences à domicile. Les informations appartiennent aux utilisateurs, et ils peuvent choisir explicitement de les partager avec les produits Works with Nest.

Le but de cette autorisation est d'offrir à vos clients un moyen sécurisé d'accorder l'accès aux données de leurs appareils Nest.

Le flux se présente comme suit:

Présentation des autorisations

Application ou site Web du produit avant autorisation

Sur le site ou l'application de votre produit, vous pouvez fournir aux clients un moyen d'autoriser votre produit à accéder aux données de leurs appareils Nest. Pour ce faire, créez un bouton ou un autre élément de l'interface utilisateur pour lancer le flux OAuth.

Lorsque vous intégrez l'autorisation utilisateur dans votre application, vous pouvez:

  • utiliser un navigateur externe pour autoriser une application
  • utiliser une nouvelle page pour authentifier une webapp

Pour en savoir plus sur la conception, consultez les Règles de conception de Nest.

iFrame

Les cadres iFrame présentent des informations, soit intégrées dans une page Web, soit sous forme de WebView dans une application native. Le flux OAuth n'est pas compatible avec l'intégration dans des cadres iFrame.

Connexion à Nest

Si l'utilisateur n'est pas déjà connecté, nous l'invitons à le faire.

Notification de connexion (non propriétaire uniquement)

Si l'utilisateur est membre d'un compte familial et n'est pas propriétaire de toutes les structures du compte, une notification de connexion s'affiche après la connexion. Cette notification répertorie les structures avec lesquelles l'utilisateur peut autoriser votre produit Works with Nest.

Si l'utilisateur est le titulaire du compte, la notification de connexion ne s'affiche pas et la page des autorisations s'affiche immédiatement après la connexion.

Pour en savoir plus, consultez la section Comptes Famille.

Autorisation des utilisateurs

Autorisations Nest

Nous inviterons l'utilisateur à accorder l'accès à votre produit. Cette page affiche les autorisations et les descriptions que vous avez saisies lors de la création de votre client.

Pour en savoir plus, consultez la page Présentation des autorisations.

Autorisation des utilisateurs

Application ou site du produit après autorisation

Une fois que votre client a autorisé votre produit Works with Nest, nous vous envoyons un code d'autorisation que votre produit peut échanger contre un jeton d'accès. Votre produit Works with Nest peut ensuite envoyer le jeton d'accès avec des appels d'API pour accéder aux données Nest.

Vos clients peuvent révoquer l'accès à tout moment, ce qui empêchera votre produit Works with Nest d'envoyer d'autres requêtes pour les données d'appareil du client.

Pour savoir comment configurer un flux d'autorisation pour un utilisateur et obtenir un jeton d'accès, consultez la page Authentification et autorisation avec OAuth 2.0.