API de estrutura

Os usuários podem adicionar um máximo de três estruturas , com múltiplos dispositivos por estrutura.

Toda a valores abaixo são encontradas em cada uma structures/ structure_id no documento JSON.

structure_id

Número de identificação da estrutura. Ao fazer uma chamada para este local de dados, você pode acessar os valores dos dados nesta estrutura.

Detalhes
https://developer-api.nest.com/structures/ structure_id /structure_id
Devoluções	string Exemplo: "VqFabWH21nw ..."
Acesso	somente leitura
Disponível em	Termostato lido / v1-v6 Leitura / gravação do termostato / v1-v6 Leitura de fumaça + CO / v1-v5 Leitura ausente / v1-v2 Leitura / gravação ausente / v1-v2 Gravação ETA / v1-v2 Código postal lido / v2 Leitura da câmera / v1-v3 Leitura da câmera + imagens / v1-v4 Leitura / gravação da câmera / v1-v3 Leitura / gravação da câmera + imagens / v1-v4 Energia lida / v2

termostatos

Lista dos termostatos da estrutura, por identificador único do dispositivo. Esta é uma matriz de objetos JSON que inclui todos os termostatos na estrutura.

Detalhes
https://developer-api.nest.com/structures/ structure_id /thermostats
Devoluções	array Exemplo: [ "peyiJNo0IldT2YlIVtYaGQ",... ]
Acesso	somente leitura
Disponível em	Termostato lido / v1-v6 Leitura / gravação do termostato / v1-v6 Leitura de fumaça + CO / v1-v5 Leitura ausente / v1-v2 Leitura / gravação ausente / v1-v2 Gravação ETA / v1-v2 Leitura da câmera / v2-v3 Leitura da câmera + imagens / v2-v4 Leitura / gravação da câmera / v2-v3 Leitura / gravação da câmera + imagens / v2-v4

smoke_co_alarms

Lista de alarmes de fumaça + CO na estrutura, por identificador único do dispositivo. Este é um array de objetos JSON que inclui todos os alarmes de fumaça + CO na estrutura.

Detalhes
https://developer-api.nest.com/structures/ structure_id /smoke_co_alarms
Devoluções	array Exemplo: [ "RTMTKxsQTCxzVcsySOHPxKoF4OyCifrs",... ]
Acesso	somente leitura
Disponível em	Termostato lido / v1-v6 Leitura / gravação do termostato / v1-v6 Leitura de fumaça + CO / v1-v5 Leitura ausente / v1-v2 Leitura / gravação ausente / v1-v2 Gravação ETA / v1-v2 Leitura da câmera / v2-v3 Leitura da câmera + imagens / v2-v4 Leitura / gravação da câmera / v2-v3 Leitura / gravação da câmera + imagens / v2-v4

máquinas fotográficas

Lista das câmeras da estrutura, por identificador único do dispositivo. Esta é uma matriz de objetos JSON que inclui todas as câmeras na estrutura.

Detalhes
https://developer-api.nest.com/structures/ structure_id /cameras
Devoluções	array Exemplo: [ "awJo6rH...",... ]
Acesso	somente leitura
Disponível em	Termostato lido / v4-v6 Leitura / gravação do termostato / v4-v6 Leitura de fumaça + CO / v4-v5 Leitura ausente / v2 Leitura / gravação ausente / v2 Gravação ETA / v2 Leitura da câmera / v1-v3 Leitura da câmera + imagens / v1-v4 Leitura / gravação da câmera / v1-v3 Leitura / gravação da câmera + imagens / v1-v4

longe

Indica o estado de ocupação da estrutura.

Estruturas têm dois estados relacionados com a presença: home ou away . Quando nenhum movimento é detectado na casa, a estrutura vai mudar de home para away .

Detalhes
https://developer-api.nest.com/structures/ structure_id /away
Devoluções	string Valores: "home", "away"
Acesso	ler escrever
Disponível em	Leitura: Termostato lido / v1-v6 Leitura / gravação do termostato / v1-v6 Leitura de fumaça + CO / v1-v5 Leitura ausente / v1-v2 Leitura / gravação ausente / v1-v2 Gravação ETA / v1-v2 Escrever: Leitura / gravação ausente / v1-v2

nome

Nome de exibição da estrutura definido pelo usuário.

Detalhes
https://developer-api.nest.com/structures/ structure_id /name
Devoluções	string Exemplos: "Minha casa", "Casa na praia", "Casa na montanha"
Acesso	ler escrever
Disponível em	Leitura: Termostato lido / v1-v6 Leitura / gravação do termostato / v1-v6 Leitura de fumaça + CO / v1-v5 Leitura ausente / v1-v2 Leitura / gravação ausente / v1-v2 Gravação ETA / v1-v2 Código postal lido / v2 Leitura da câmera / v1-v3 Leitura da câmera + imagens / v1-v4 Leitura / gravação da câmera / v1-v3 Leitura / gravação da câmera + imagens / v1-v4 Energia lida / v2 Estrutura de leitura / gravação / v1 Escrever: Estrutura de leitura / gravação / v1

Código do país

O código do país, em ISO 3166 alfa-2 formato.

Detalhes
https://developer-api.nest.com/structures/ structure_id /country_code
Devoluções	string Exemplos: "US", "CA", "UK"
Acesso	somente leitura
Disponível em	Termostato lido / v1-v6 Leitura / gravação do termostato / v1-v6 Leitura de fumaça + CO / v1-v5 Leitura ausente / v1-v2 Leitura / gravação ausente / v1-v2 Gravação ETA / v1-v2

Código postal

Código postal ou CEP, dependendo do país.

Detalhes
https://developer-api.nest.com/structures/ structure_id /postal_code
Devoluções	string Exemplos: "94304", "94304-1027", "EC1A 1BB"
Acesso	somente leitura
Disponível em	Código postal lido / v1-v2

Peak_period_start_time

Hora de início do horário de pico de energia evento, na ISO 8601 formato.

Detalhes
https://developer-api.nest.com/structures/ structure_id /peak_period_start_time
Devoluções	string Exemplo: "2016-12-31T23: 59: 59.000Z"
Acesso	somente leitura
Disponível em	Termostato lido / v1-v6 Leitura / gravação do termostato / v1-v6 Leitura de energia / v1-v2

peak_period_end_time

Acabar época da hora do rush energia evento, na ISO 8601 formato.

Detalhes
https://developer-api.nest.com/structures/ structure_id /peak_period_end_time
Devoluções	string Exemplo: "2016-12-31T23: 59: 59.000Z"
Acesso	somente leitura
Disponível em	Termostato lido / v1-v6 Leitura / gravação do termostato / v1-v6 Leitura de energia / v1-v2

fuso horário

Fuso horário na estrutura, no fuso horário IANA formato.

Detalhes
https://developer-api.nest.com/structures/ structure_id /time_zone
Devoluções	string Exemplo: "America / Los_Angeles"
Acesso	somente leitura
Disponível em	Termostato lido / v1-v6 Leitura / gravação do termostato / v1-v6 Leitura de fumaça + CO / v1-v5 Leitura ausente / v1-v2 Leitura / gravação ausente / v2 Gravação ETA / v1-v2

eta

ETA (tempo estimado de chegada) é um objeto que pode ser definido em uma estrutura. É usado para informar a Nest que o usuário deve voltar para casa em um horário específico. Para obter informações sobre como fazer uma chamada de ETA, consulte o Longe Guia .

Detalhes
https://developer-api.nest.com/structures/ structure_id /eta
Devoluções	object Exemplo: "myTripID1024", "2014-10-31T22: 42: 00.000Z", "2016-12-31T23: 59: 59.000Z"
Parâmetros	trip_id Uma string definida pelo usuário que identifica a viagem estimated_arrival_window_begin Um carimbo de hora em ISO 8601 formato. Deve ser maior que NOW . estimated_arrival_window_end Um carimbo de hora em ISO 8601 formato. Deve ser maior que estimated_arrival_window_begin .
Acesso	somente escrita
Disponível em	Gravação ETA / v1-v2

eta_begin

Timestamp da primeira hora prevista de chegada na ISO 8601 formato. Usado para acionar ações ou eventos.

Detalhes
https://developer-api.nest.com/structures/ structure_id /eta_begin
Devoluções	string Exemplo: "2016-12-31T23: 59: 59.000Z"
Acesso	somente leitura
Disponível em	ETA lido / v1

rhr_enrollment

Rush Hour Recompensas status de inscrição.

Detalhes
https://developer-api.nest.com/structures/ structure_id /rhr_enrollment
Devoluções	boolean Valores: verdadeiro, falso
Acesso	somente leitura
Disponível em	Leitura de energia / v1-v2

wwn_security_state

Estado de segurança da estrutura.

Detalhes
https://developer-api.nest.com/structures/ structure_id /wwn_security_state
Modelo	string enum Valores: "ok", "deter"
Acesso	somente leitura
Disponível em	Leitura do estado de segurança / v1

Onde está a

Um objecto contendo onde identificadores ( where_id e name ) para dispositivos na estrutura. name é o nome do dispositivo de exibição. Pode ser qualquer nome de sala de uma lista que fornecemos ou um nome personalizado.

Para mais informações sobre wheres , consulte a Estrutura Guia .

Saiba mais sobre onde nomes para termostatos Ninho , Ninho Protege e ninho de webcams .

Detalhes
https://developer-api.nest.com/structures/ structure_id /wheres
Devoluções	object
Acesso	somente leitura
Disponível em	Leitura: Termostato lido / v3-v6 Leitura / gravação do termostato / v3-v6 Leitura de fumaça + CO / v3-v5 Leitura da câmera / v1-v3 Leitura da câmera + imagens / v1-v4 Leitura / gravação da câmera / v1-v3 Leitura / gravação da câmera + imagens / v1-v4

where_id

Um identificador exclusivo, gerado-Nest que representa name .

where_id é automaticamente criado e retornado durante a chamada para criar name .

Detalhes
https://developer-api.nest.com/structures/ structure_id /wheres/ where_id /where_id
Devoluções	string Exemplo: "Fqp6wJI ..."
Acesso	somente leitura
Disponível em	Leitura: Termostato lido / v3-v6 Leitura / gravação do termostato / v3-v6 Leitura de fumaça + CO / v3-v5 Leitura da câmera / v1-v3 Leitura da câmera + imagens / v1-v4 Leitura / gravação da câmera / v1-v3 Leitura / gravação da câmera + imagens / v1-v4

nome

O nome de exibição do dispositivo.

Detalhes
https://developer-api.nest.com/structures/ structure_id /wheres/ where_id /name
Devoluções	string Exemplo: "Quarto"
Acesso	ler escrever
Disponível em	Leitura: Termostato lido / v3-v6 Leitura / gravação do termostato / v3-v6 Leitura de fumaça + CO / v3-v5 Leitura da câmera / v1-v3 Leitura da câmera + imagens / v1-v4 Leitura / gravação da câmera / v1-v3 Leitura / gravação da câmera + imagens / v1-v4

co_alarm_state

Status de alarme de CO.

Detalhes
https://developer-api.nest.com/structures/ structure_id /co_alarm_state
Devoluções	string enum Valores: "ok", "aviso", "emergência"
Acesso	somente leitura
Disponível em	Leitura de fumaça + CO / v5

smoke_alarm_state

Status do alarme de fumaça.

Detalhes
https://developer-api.nest.com/structures/ structure_id /smoke_alarm_state
Devoluções	string enum Valores: "ok", "aviso", "emergência"
Acesso	somente leitura
Disponível em	Leitura de fumaça + CO / v5