Notice: We're retiring Works with Nest. See the home page for more information.
O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.
Esta página foi traduzida pela API Cloud Translation.
Switch to English

API Referência Nest

Os modelos de API um ninho de origem física ou de construção como uma estrutura, com Nest Learning termostatos, Ninho Protege, e ninho Cams como dispositivos na estrutura. Essa estrutura também contém informações sobre a casa como um todo (como Ausente ou estado ETA, ou as horas de ponta ativos).

Cada elemento de dados na estrutura é endereçável por uma URL de recursos (chamados "locais de dados") em um documento JSON compartilhada. Cada localização de dados pode armazenar cadeias de caracteres, números, booleanos, objectos pai / filho, ou matrizes.

Explorar o modelo de dados com este Referência API interativa .

A partir da API, você pode sincronizar dados a partir de locais em vários níveis no modelo de dados, por exemplo:

  • uma estrutura inteira, incluindo todos os dispositivos
  • um único dispositivo numa estrutura
  • um grupo de valores de dados (temperatura ambiente actual e)
  • um valor de dados único (estado de saúde da bateria)

Seus produtos devem responder pensativamente a eventos como estes:

No entanto, tenha em mente que cada um dos objetos baseados em dispositivos estão trabalhando sob restrições do mundo real. Por exemplo, o termostato não deve executar o ar condicionado quando o calor de emergência está activado. Nossa API é projetado para proteger os nossos dispositivos e home do usuário, e vai impedir que determinadas ações se eles seria surpreendente ou perigosas.

Permissões e dados do dispositivo compartilhados

A capacidade de ler ou escrever para um local de dados é controlado por permissões. grupos de permissão prover leitura, de escrita ou leitura / escrita para valores de dados seleccionados em dispositivos e estruturas.

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

De dados e privacidade

Os dados envolvidos com produtos para o lar pode ser muito pessoal. dados do sensor casa contém informações sobre como as pessoas vivem suas vidas em seu espaço pessoal. A segurança e processamento de dados que é muito importante, e um foco significativo no ninho. Podemos torná-lo claro para os usuários que tipo de dados que temos, como ele é usado, e onde eles podem controlá-lo.

Saiba mais sobre nossos pontos de vista sobre privacidade .

metadados

Metadados são informações adicionais que é fornecido quando você faz uma chamada para o terminal de nível root:

https://developer-api.nest.com/

access_token

Após autorização do usuário, o produto utiliza um token de acesso para fazer chamadas de API para o serviço Nest. Este token de acesso serve como prova de que um usuário tenha autorizado o seu produto para chamadas feitas no seu nome.

detalhes
Devoluções string
Exemplo: "c.FmDPkzyzaQe ..."

client_version

A versão do cliente é a última versão autorizada pelo usuário de um cliente, e está associada a um access_token .

Quando você atualizar as permissões para um cliente, a versão do cliente é incrementado, eo usuário é notificado de que uma atualização está disponível. Seus usuários devem aceitar essa atualização do cliente antes que eles possam usar o produto atualizado.

detalhes
Devoluções number
Exemplos: 1, 17, 42

ID do usuário

O ID do usuário permite identificar usuários em chamadas de API. Este identificador é diferente para cada fábrica, com produtos Nest e combinação de usuário.

Por exemplo, se o utilizador tiver autorizado um Works com ninho produto A e trabalha com produto Nest B, em seguida, o produto A tem um user_id valor para o utilizador 1, e o produto B tem um diferente user_id valor para o utilizador 1.

detalhes
Devoluções string
Exemplo: z.1.1.7DHps ...