La API de Nest proporciona información que puede utilizar para crear experiencias hogareñas. En última instancia, la información es propiedad de los usuarios, y los usuarios pueden elegir explícitamente compartir esta información con los productos Works with Nest.
El propósito de la autorización es brindar a sus clientes un medio seguro para otorgar acceso a los datos de su dispositivo Nest.
El flujo se ve así:
Sitio del producto o aplicación antes de la autorización
En el sitio o aplicación de su producto, puede proporcionar una forma para que los clientes le den acceso a su producto a los datos de su dispositivo Nest. Para hacer esto, cree un botón u otro elemento de la interfaz de usuario para iniciar el flujo de OAuth.
Cuando crea una autorización de usuario en su aplicación, puede:
- utilizar un navegador externo para autorizar una aplicación
- usar una nueva página para autenticar una aplicación web
Para mayor orientación diseño, ver las políticas de diseño Nest .
iFrames
Los iFrames presentan información, ya sea incrustada en una página web o como vista web en una aplicación nativa. El flujo de OAuth no admite la incrustación en iFrames .
Inicio de sesión de Nest
Si el usuario aún no ha iniciado sesión, le pedimos que inicie sesión.
Notificación de conexión (solo para no propietarios)
Si el usuario es miembro de una cuenta familiar y no posee todas las estructuras de la cuenta, aparece una notificación de conexión después de iniciar sesión. Esta notificación enumera las estructuras con las que el usuario puede autorizar su producto Works with Nest.
Si el usuario es el propietario de la cuenta, la notificación de conexión no aparece y la página de permisos se muestra inmediatamente después de iniciar sesión.
Para obtener más información, ver cuentas de la familia .
Permisos de Nest
Le pediremos al usuario que otorgue acceso a su producto. Esta página muestra los permisos y descripciones que ingresó cuando creó su cliente.
Para obtener más información, consulte la Descripción general de permisos .
Sitio del producto o aplicación después de la autorización
Una vez que su cliente autorice su producto Works with Nest, le enviaremos un código de autorización que su producto puede cambiar por un token de acceso. Su producto Works with Nest puede enviar el token de acceso con llamadas a la API para acceder a los datos de Nest.
Sus clientes pueden revocar el acceso en cualquier momento, lo que evitará que su producto Works with Nest realice más solicitudes de datos del dispositivo del cliente.
Para aprender cómo configurar un flujo de autorización para un usuario y obtener un token de acceso, ver autentificación y autorización con OAuth 2.0 .