Información sobre el servicio de Nest
Las aplicaciones de Nest permiten a los usuarios conectarse con su casa desde cualquier lugar. Todos los dispositivos (termostatos, Nest Protect y cámaras) y las aplicaciones (iOS, Android y apps web) se conectan al servicio de Nest.
El servicio de Nest proporciona un modelo de datos de la casa. Los dispositivos y las aplicaciones leen de este modelo de datos para tomar las medidas adecuadas. Actualizan el modelo de datos para reflejar los cambios en el sistema.
Por ejemplo, un termostato lee la temperatura final del modelo de datos. Establece la temperatura ambiente en su medición actual y envía datos del sensor a la Función En casa/Ausente, que ajusta el modo de estructura según corresponda.
Los dispositivos Nest funcionan en entornos limitados. La energía es limitada y la conectividad de la red doméstica puede no ser confiable. Tus productos y servicios pueden aprovechar nuestros algoritmos de dispositivos para ofrecer a los usuarios una experiencia del hogar intuitiva y sencilla.
Modelo de datos
La API de Nest se representa como un documento JSON con atributos de nivel superior de metadata, devices y structures. Tus productos Works with Nest usan este documento de JSON para interactuar con los dispositivos Nest y los cambios de estado relacionados, y reaccionar a ellos.
Nest structures representa estructuras físicas en el mundo real. Sirven como punto de organización de devices y almacenan datos del edificio en general.
Por lo general, un structure es una casa del usuario.
Nest devices representa dispositivos físicos (Termostatos, Protects y Cámaras) dentro de una estructura.
Se puede acceder a cada elemento de datos en el documento JSON mediante una URL (también conocida como ubicaciones de datos). Los productos Works with Nest pueden leer y escribir en secciones de este documento y suscribirse a cambios. Esta función de suscripción permite que los productos Works with Nest reaccionen en tiempo real a los cambios realizados en el sistema, como cuando se apagan las luces cuando un usuario establece la estructura en Ausente.
Los objetos también funcionan con restricciones del mundo real. El modelo de datos protege los dispositivos y el hogar de los usuarios mediante la prevención de acciones inesperadas y peligrosas. Por ejemplo, cuando el calefactor de emergencia está habilitado, el termostato no hace funcionar el aire acondicionado.
Explora el modelo de datos con esta referencia interactiva de la API.
Estado previsto
El servicio de Nest almacena el estado autorizado del sistema, y los productos Works with Nest se suscriben a cambios. Modificar este estado (por ejemplo, para cambiar la temperatura final del termostato) hace que el servicio envíe una notificación de cambio a todos los suscriptores.
Debido a que esta propagación tiene un retraso y las redes pueden ser poco confiables, es posible que el estado que observa un producto no sea el estado que actualmente observan otros productos o el servicio. Finalmente, el estado se sincroniza a medida que se transmiten mensajes entre varios productos.
Este modelo de publicación y suscripción orientado al documento proporciona interacciones de aplicaciones responsivas.
Cómo usar el servicio de Nest
Para acceder a los extremos de REST en el servicio de Nest, usa HTTPS en tu producto. Hay muchas bibliotecas cliente de terceros que pueden usarse para este fin.
Permisos y autorización
Queremos permitir que los desarrolladores creen productos y servicios que mejoren las casas sin comprometer la privacidad y la seguridad de los usuarios. Todas nuestras comunicaciones son seguras, y el usuario siempre otorga permiso de forma explícita para acceder a los datos. Para obtener más información, consulta Descripción general de los permisos.
La autorización se controla mediante el protocolo OAuth 2.0. Cuando un usuario acepta brindar acceso al nivel de permiso solicitado, Nest autentica la solicitud y se le otorga un token de acceso. Ese token de acceso se puede usar para acceder a la API de Nest e interactuar con las estructuras y los dispositivos del usuario.
Cuando se otorga un token de acceso, se establece una relación de confianza entre un usuario, un producto Works with Nest y Nest. Los usuarios pueden revocar el acceso en cualquier momento.
Para obtener información sobre cómo autorizar una conexión a la API de Nest, consulta la Descripción general de la autorización.