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:
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 .
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 .
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 .