Panoramica dell'autorizzazione

L'API Nest fornisce informazioni che puoi utilizzare per creare esperienze in casa. Alla fine le informazioni sono di proprietà degli utenti, che possono scegliere esplicitamente di condividerle con i prodotti Works with Nest.

Lo scopo dell'autorizzazione è dare ai tuoi clienti un mezzo sicuro per concedere l'accesso ai dati dei loro dispositivi Nest.

Il flusso ha il seguente aspetto:

Panoramica delle autorizzazioni

Sito o app del prodotto prima dell'autorizzazione

Nel sito o nell'app del prodotto, puoi offrire ai clienti un modo per concedere al prodotto l'accesso ai dati dei loro dispositivi Nest. Per farlo, crea un pulsante o un altro elemento UI per avviare il flusso OAuth.

Quando crei l'autorizzazione utente nella tua app, puoi:

  • utilizzo di un browser esterno per autorizzare un'app
  • usa una nuova pagina per autenticare un'app web

Per ulteriori indicazioni sulla progettazione, consulta le norme relative alla progettazione di Nest.

iFrame

Gli iFrame presentano informazioni incorporate in una pagina web o come visualizzazione web in un'app nativa. Il flusso OAuth non supporta l'incorporamento in iframe.

Accesso a Nest

Chiediamo all'utente di eseguire l'accesso se l'utente non ha ancora eseguito l'accesso.

Notifica di connessione (solo per utenti non proprietari)

Se l'utente è membro di un account famiglia e non possiede tutte le strutture dell'account, viene visualizzata una notifica di connessione dopo l'accesso. In questa notifica sono indicate le strutture con cui l'utente può autorizzare il tuo prodotto Works with Nest.

Se l'utente è il proprietario dell'account, la notifica di connessione non viene visualizzata e la pagina delle autorizzazioni viene visualizzata subito dopo l'accesso.

Per ulteriori informazioni, consulta la sezione Account famiglia.

Autorizzazione utente

Autorizzazioni Nest

Chiederemo all'utente di concedere l'accesso al prodotto. Questa pagina mostra le autorizzazioni e le descrizioni che hai inserito quando hai creato il client.

Per ulteriori informazioni, consulta la panoramica delle autorizzazioni.

Autorizzazione utente

Sito o app del prodotto dopo autorizzazione

Dopo che il tuo cliente autorizza il tuo prodotto Works with Nest, ti invieremo un codice di autorizzazione che il tuo prodotto può scambiare con un token di accesso. Il prodotto Works with Nest può quindi inviare il token di accesso con chiamate API per accedere ai dati Nest.

I tuoi clienti possono revocare l'accesso in qualsiasi momento, il che impedirà al tuo prodotto Works with Nest di effettuare ulteriori richieste per i dati del dispositivo del cliente.

Per informazioni su come configurare un flusso di autorizzazione per un utente e ottenere un token di accesso, consulta Autenticazione e autorizzazione con OAuth 2.0.