Visão geral da autorização

A API Nest fornece informações que você pode usar para criar experiências caseiras. Em última análise, as informações pertencem aos usuários, e os usuários podem escolher explicitamente compartilhar essas informações com os produtos Works with Nest.

O objetivo da autorização é fornecer a seus clientes um meio seguro de conceder acesso aos dados de seus dispositivos Nest.

O fluxo é assim:

Visão geral da autorização

Site do produto ou aplicativo antes da autorização

No site do seu produto ou aplicativo, você pode fornecer aos clientes uma maneira de dar ao seu produto acesso aos dados do dispositivo Nest. Para fazer isso, crie um botão ou outro elemento de IU para iniciar o fluxo OAuth.

Ao criar autorização de usuário em seu aplicativo, você pode:

  • use um navegador externo para autorizar um aplicativo
  • use uma nova página para autenticar um webapp

Para mais orientações design, ver as políticas de design ninho .

iFrames

Os iFrames apresentam informações incorporadas em uma página da web ou como uma visualização da web em um aplicativo nativo. O fluxo OAuth não suporta a incorporação em iFrames .

Login do Nest

Se o usuário ainda não estiver conectado, solicitamos que ele faça o login.

Notificação de conexão (não proprietário apenas)

Se o usuário for membro de uma conta familiar e não possuir todas as estruturas da conta, uma notificação de conexão aparecerá após o login. Esta notificação lista com quais estruturas o usuário pode autorizar seu produto Works with Nest.

Se o usuário for o proprietário da conta, a notificação de conexão não aparecerá e a página de permissões será exibida imediatamente após o login.

Para mais informações, consulte Contas da família .

Autorização do usuário

Permissões de ninho

Solicitaremos ao usuário que conceda acesso ao seu produto. Esta página exibe as permissões e descrições que você inseriu quando criou seu cliente.

Para mais informações, consulte a Visão geral das permissões .

Autorização do usuário

Site do produto ou aplicativo após autorização

Depois que seu cliente autorizar seu produto Works with Nest, enviaremos um código de autorização que seu produto pode trocar por um token de acesso. Seu produto Works with Nest pode então enviar o token de acesso com chamadas de API para acessar os dados Nest.

Seus clientes podem revogar o acesso a qualquer momento, o que impedirá seu produto Works with Nest de fazer mais solicitações de dados de dispositivo do cliente.

Para saber como configurar um fluxo de autorização para um usuário e obter um token de acesso, consulte autenticação e autorização com OAuth 2.0 .