L'architettura dell'API Nest

Informazioni sul servizio Nest

Le applicazioni Nest permettono agli utenti di connettersi con la loro casa ovunque si trovino. Tutti i dispositivi e le videocamere Nest (Termostati, Protect e videocamere) si connettono al servizio Nest.

Esempio da cloud a cloud

Il servizio Nest fornisce un modello dati della casa. Dispositivi e applicazioni letti da questo modello di dati per intraprendere le azioni appropriate. Aggiornano il modello dei dati in modo che rifletta le modifiche apportate al sistema.

Ad esempio, un termostato legge la sua temperatura ottimale dal modello di dati. Imposta la temperatura ambiente sulla misurazione attuale e invia i dati dei sensori alla funzionalità A casa/Fuori casa, regolando di conseguenza la modalità struttura.

I dispositivi Nest funzionano in ambienti vincolati. La potenza è limitata e la connettività di rete domestica potrebbe essere inaffidabile. I tuoi prodotti e servizi possono sfruttare i nostri algoritmi per offrire agli utenti un'esperienza di casa semplice e intuitiva.

Il modello dei dati

L'API Nest è rappresentata da un documento JSON con attributi di primo livello come metadata, devices e structures. I tuoi prodotti Works with Nest utilizzano questo documento JSON per interagire con i dispositivi Nest e reagire alle relative modifiche e interagire con essi.

Nest structures rappresenta strutture fisiche nel mondo reale. Servono come punto organizzativo per devices e memorizzano i dati per l'edificio nel suo complesso. In genere, un structure è la casa di un utente.

Nest devices rappresenta i dispositivi fisici (termostati, dispositivi Protect e videocamere) all'interno di una struttura.

Ogni elemento di dati nel documento JSON è raggiungibile tramite URL (chiamato anche "località dei dati"). I prodotti Works with Nest possono leggere e scrivere sezioni del presente documento e iscriversi ai cambiamenti. Questa funzionalità di abbonamento consente ai prodotti Works with Nest di reagire in tempo reale alle modifiche apportate al sistema, ad esempio allo spegnimento delle luci quando un utente imposta la struttura su Fuori.

Gli oggetti funzionano anche in condizioni reali. Il modello di dati protegge i dispositivi e l'abitazione degli utenti evitando azioni sorprendenti e pericolose. Ad esempio, il termostato non usa il condizionatore quando è abilitato il riscaldamento di emergenza.

Esplora il modello di dati con questo riferimento API interattivo.

Stato previsto

Il servizio Nest archivia lo stato di autorizzazione del sistema e i prodotti Works with Nest si abbonano alle modifiche. La modifica di questo stato (ad esempio, per modificare la temperatura ottimale del termostato) provoca l'invio, da parte del servizio, di una notifica di modifica a tutti i sottoscrittori.

Dato che questa propagazione presenta un ritardo e le reti possono non essere attendibili, lo stato osservato da un prodotto potrebbe non essere attualmente osservato da altri prodotti o dal servizio. Lo stato viene sincronizzato alla fine quando i messaggi vengono trasmessi tra i vari prodotti.

Questo modello di pubblicazione/abbonamento orientato ai documenti offre interazioni adattabili delle applicazioni.

Usare il servizio Nest

Per accedere agli endpoint REST nel servizio Nest, utilizza il protocollo HTTPS nel tuo prodotto. A tale scopo, sono disponibili molte librerie client di terze parti.

Autorizzazioni e autorizzazioni

Vogliamo consentire agli sviluppatori di creare prodotti e servizi che migliorino le case, senza compromettere la privacy e la sicurezza degli utenti. Tutte le nostre comunicazioni sono al sicuro e l'utente concede sempre l'autorizzazione esplicita per accedere ai dati. Per ulteriori informazioni, consulta la panoramica delle autorizzazioni.

L'autorizzazione è gestita dal protocollo OAuth 2.0. Quando un utente accetta di fornire l'accesso al livello di autorizzazione richiesto, Nest autentica la richiesta e il token di accesso viene concesso al richiedente. Questo token di accesso può essere utilizzato per accedere all'API Nest e interagire con le strutture e i dispositivi dell'utente.

La concessione di un token di accesso stabilisce una relazione di attendibilità tra un utente, un prodotto Works with Nest e un prodotto Nest. Gli utenti possono revocare l'accesso in qualsiasi momento.

Per informazioni su come autorizzare una connessione all'API Nest, consulta la Panoramica delle autorizzazioni.