termostato API

A API Nest funciona com todos os modelos Nest Learning Thermostat ™, exceto para o termostato E com o calor Fazer a ligação na UE.

Os usuários podem adicionar vários termostatos ninho para o devices/thermostats grupo, até o máximo por estrutura . Quando você faz uma chamada para este local de dados, você pode acessar Nest dados Termostato (valores de dados para dispositivos na estrutura).

Toda a valores abaixo são encontradas em cada devices/thermostats/ device_id no documento JSON.

ID de dispositivo

Nest Thermostat identificador único.

detalhes
https://developer-api.nest.com/devices/thermostats/ device_id /device_id
Devoluções	string Exemplo: "peyiJNo0IldT2YlIVtYaGQ"
Acesso	somente leitura
Disponível em	Termostato de leitura / v1-v6 Termostato de leitura / gravação / v1-v6

localidade

Especifica o idioma e região (ou país) preferência.

detalhes
https://developer-api.nest.com/devices/thermostats/ device_id /locale
Devoluções	string Exemplos: "en-GB", "en-US", "es-US", "fr-CA", "fr-CA", "nl-NL"
Acesso	somente leitura
Disponível em	Termostato de leitura / v1-v6 Termostato de leitura / gravação / v1-v6

versão do software

Versão do software.

detalhes
https://developer-api.nest.com/devices/thermostats/ device_id /software_version
Devoluções	string Exemplo: "4.0"
Acesso	somente leitura
Disponível em	Termostato de leitura / v1-v6 Termostato de leitura / gravação / v1-v6

structure_id

Estruturar identificador único.

detalhes
https://developer-api.nest.com/devices/thermostats/ device_id /structure_id
Devoluções	string Exemplo: "VqFabWH21nw ..."
Acesso	somente leitura
Disponível em	Termostato de leitura / v1-v6 Termostato de leitura / gravação / v1-v6

nome

do nome de exibição do dispositivo. Pode ser qualquer nome da sala a partir de uma lista que oferecemos, ou um nome personalizado.

detalhes
https://developer-api.nest.com/devices/thermostats/ device_id /name
Devoluções	string Exemplo: "Corredor"
Acesso	somente leitura
Disponível em	Termostato de leitura / v1-v6 Termostato de leitura / gravação / v1-v6

NAME_LONG

nome de exibição longo do dispositivo. Inclui um personalizado (etiqueta), criado pelo usuário, ou através wheres .

detalhes
https://developer-api.nest.com/devices/thermostats/ device_id /name_long
Devoluções	string Exemplo: "Corredor termostato (em cima)"
Acesso	somente leitura
Disponível em	Termostato de leitura / v1-v6 Termostato de leitura / gravação / v1-v6

last_connection

Timestamp da última interação bem-sucedida com o serviço Nest, na ISO 8601 formato.

detalhes
https://developer-api.nest.com/devices/thermostats/ device_id /last_connection
Devoluções	string Exemplo: "2016-12-31T23: 59: 59.000Z"
Acesso	somente leitura
Disponível em	Termostato de leitura / v1-v6 Termostato de leitura / gravação / v1-v6

está online

o status da conexão do dispositivo com o serviço Nest.

detalhes
https://developer-api.nest.com/devices/thermostats/ device_id /is_online
Devoluções	boolean Valores: verdadeiro, falso
Acesso	somente leitura
Disponível em	Termostato de leitura / v1-v6 Termostato de leitura / gravação / v1-v6

can_cool

a capacidade do sistema para refrigerar (tem AC).

detalhes
https://developer-api.nest.com/devices/thermostats/ device_id /can_cool
Devoluções	boolean Valores: verdadeiro, falso
Acesso	somente leitura
Disponível em	Termostato de leitura / v1-v6 Termostato de leitura / gravação / v1-v6

can_heat

capacidade do sistema ao calor.

detalhes
https://developer-api.nest.com/devices/thermostats/ device_id /can_heat
Devoluções	boolean Valores: verdadeiro, falso
Acesso	somente leitura
Disponível em	Termostato de leitura / v1-v6 Termostato de leitura / gravação / v1-v6

is_using_emergency_heat

estatuto de calor de emergência em sistemas com bombas de calor para refrigeração.

Quando emergência Calor está em:

• O utilizador pode ajustar a temperatura alvo no dispositivo, mas não pode alterar o modo de emergência até calor é desligado
• O hvac_mode ainda pode ser alterado por meio da API

Veja O que há de calor de emergência? Para mais informações sobre como o Nest Thermostat suporta calor de emergência.

detalhes
https://developer-api.nest.com/devices/thermostats/ device_id /is_using_emergency_heat
Devoluções	boolean Valores: verdadeiro, falso
Acesso	somente leitura
Disponível em	Termostato de leitura / v1-v6 Termostato de leitura / gravação / v1-v6

has_fan

a capacidade do sistema para controlar o ventilador, independentemente, de aquecimento ou de arrefecimento.

detalhes
https://developer-api.nest.com/devices/thermostats/ device_id /has_fan
Devoluções	boolean Valores: verdadeiro, falso
Acesso	somente leitura
Disponível em	Termostato de leitura / v1-v6 Termostato de leitura / gravação / v1-v6

fan_timer_active

Indica se o temporizador do ventilador está envolvida; utilizado com fan_timer_duration para ligar o ventilador para uma duração predefinida (definido pelo utilizador).

Veja Controle Fan avançada para mais informações sobre como os clientes definir a duração do ventilador.

detalhes
https://developer-api.nest.com/devices/thermostats/ device_id /fan_timer_active
Devoluções	boolean Valores: verdadeiro, falso
Acesso	ler escrever
Disponível em	Termostato de leitura / v1-v6 Termostato de leitura / gravação / v1-v6

fan_timer_timeout

Timestamp mostrando quando o temporizador do ventilador atinge 0 (tempo de paragem), em ISO 8601 formato.

detalhes
https://developer-api.nest.com/devices/thermostats/ device_id /fan_timer_timeout
Devoluções	string Exemplo: "2016-12-31T23: 59: 59.000Z"
Acesso	somente leitura
Disponível em	Termostato de leitura / v1-v6 Termostato de leitura / gravação / v1-v6

has_leaf

Exibido quando o termostato está definido para uma temperatura de poupança de energia.

detalhes
https://developer-api.nest.com/devices/thermostats/ device_id /has_leaf
Devoluções	boolean Valores: verdadeiro, falso
Acesso	somente leitura
Disponível em	Termostato de leitura / v1-v6 Termostato de leitura / gravação / v1-v6

temperature_scale

Fahrenheit ou Celsius; utilizado com indicador de temperatura.

detalhes
https://developer-api.nest.com/devices/thermostats/ device_id /temperature_scale
Devoluções	string enum Valores: "F", "C"
Acesso	ler escrever
Disponível em	Ler: Termostato de leitura / v1-v6 Termostato de leitura / gravação / v1-v6 Escrever: Termostato de leitura / gravação / v5-v6

target_temperature_f

temperatura desejado, em graus Fahrenheit completos (1 ° F). Usado quando hvac_mode = heat ou cool .

detalhes
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_f
Devoluções	number Exemplo: 72
Alcance	50-90
Acesso	ler escrever
Disponível em	Termostato de leitura / v1-v6 Termostato de leitura / gravação / v1-v6

target_temperature_c

temperatura desejado, em graus Celsius meio (0,5 ° C). Usado quando hvac_mode = heat ou cool .

detalhes
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_c
Devoluções	number Exemplo: 21,5
Alcance	9-32
Acesso	ler escrever
Disponível em	Termostato de leitura / v1-v6 Termostato de leitura / gravação / v1-v6

target_temperature_high_f

temperatura alvo máxima, apresentada em graus Fahrenheit inteiras (1 ° F). Quando usado hvac_mode = heat-cool (modo Frio Calor •).

detalhes
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_high_f
Devoluções	number Exemplo: 80
Acesso	ler escrever
Disponível em	Termostato de leitura / v1-v6 Termostato de leitura / gravação / v1-v6

target_temperature_high_c

temperatura máxima alvo, exibida pela metade graus Celsius (0,5 ° C). Quando usado hvac_mode = heat-cool (modo Frio Calor •).

detalhes
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_high_c
Devoluções	number Exemplo: 24,5
Acesso	ler escrever
Disponível em	Termostato de leitura / v1-v6 Termostato de leitura / gravação / v1-v6

target_temperature_low_f

temperatura alvo mínimo, mostrada em graus Fahrenheit inteiras (1 ° F). Quando usado hvac_mode = heat-cool (modo Frio Calor •).

detalhes
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_low_f
Devoluções	number Exemplo: 65
Acesso	ler escrever
Disponível em	Termostato de leitura / v1-v6 Termostato de leitura / gravação / v1-v6

target_temperature_low_c

A temperatura mínima alvo, exibida pela metade graus Celsius (0,5 ° C). Quando usado hvac_mode = heat-cool (modo Frio Calor •).

detalhes
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_low_c
Devoluções	number Exemplo: 19,5
Acesso	ler escrever
Disponível em	Termostato de leitura / v1-v6 Termostato de leitura / gravação / v1-v6

eco_temperature_high_f

Eco máxima Temperatura, apresentada em graus Fahrenheit inteiras (1 ° F). Usado quando hvac_mode = eco .

detalhes
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_high_f
Devoluções	number Exemplo: 80
Acesso	somente leitura
Disponível em	Termostato de leitura / v6 Termostato de leitura / gravação / v6

eco_temperature_high_c

Eco máxima Temperatura, exibida pela metade graus Celsius (0,5 ° C). Usado quando hvac_mode = eco .

detalhes
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_high_c
Devoluções	number Exemplo: 24,5
Acesso	somente leitura
Disponível em	Termostato de leitura / v6 Termostato de leitura / gravação / v6

eco_temperature_low_f

Temperatura mínima Eco, apresentada em graus Fahrenheit inteiras (1 ° F). Usado quando hvac_mode = eco .

detalhes
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_low_f
Devoluções	number Exemplo: 65
Acesso	somente leitura
Disponível em	Termostato de leitura / v6 Termostato de leitura / gravação / v6

eco_temperature_low_c

Temperatura mínima Eco, exibida pela metade graus Celsius (0,5 ° C). Usado quando hvac_mode = eco .

detalhes
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_low_c
Devoluções	number Exemplo: 19,5
Acesso	somente leitura
Disponível em	Termostato de leitura / v6 Termostato de leitura / gravação / v6

away_temperature_high_f (preterido)

temperatura de distância máxima, apresentada em graus Fahrenheit inteiras (1 ° F).

detalhes
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_high_f
Devoluções	number Exemplo: 80
Acesso	somente leitura
Disponível em	Termostato de leitura / v1-v6 Termostato de leitura / gravação / v1-v6

away_temperature_high_c (preterido)

temperatura máxima distância, exibida pela metade graus Celsius (0,5 ° C).

detalhes
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_high_c
Devoluções	number Exemplo: 24,5
Acesso	somente leitura
Disponível em	Termostato de leitura / v1-v6 Termostato de leitura / gravação / v1-v6

away_temperature_low_f (preterido)

temperatura de distância mínima, apresentada em graus Fahrenheit inteiras (1 ° F).

detalhes
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_low_f
Devoluções	number Exemplo: 65
Acesso	somente leitura
Disponível em	Termostato de leitura / v1-v6 Termostato de leitura / gravação / v1-v6

away_temperature_low_c (preterido)

temperatura de distância mínima, exibido na metade graus Celsius (0,5 ° C).

detalhes
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_low_c
Devoluções	number Exemplo: 19,5
Acesso	somente leitura
Disponível em	Termostato de leitura / v1-v6 Termostato de leitura / gravação / v1-v6

hvac_mode

Indica HVAC aquecimento sistema / modos de refrigeração, como Calor • Frio para sistemas com aquecimento e capacidade de refrigeração, ou temperaturas Eco de poupança de energia.

• hvac_mode pode ser alterado se o termostato está bloqueado
• target_temperature_f e target_temperature_c não pode ser alterada se hvac_mode = off ou eco

detalhes
https://developer-api.nest.com/devices/thermostats/ device_id /hvac_mode
Devoluções	string enum Valores: "calor", "cool", "calor-cool", "eco", "off"
Acesso	ler escrever
Disponível em	Termostato de leitura / v1-v6 Termostato de leitura / gravação / v1-v6

ambient_temperature_f

Temperatura, medida na dispositivo, em graus Fahrenheit inteiras (1 ° F).

detalhes
https://developer-api.nest.com/devices/thermostats/ device_id /ambient_temperature_f
Devoluções	number Exemplo: 72
Acesso	somente leitura
Disponível em	Termostato de leitura / v1-v6 Termostato de leitura / gravação / v1-v6

ambient_temperature_c

Temperatura, medida na dispositivo, em meio graus Celsius (0,5 ° C).

detalhes
https://developer-api.nest.com/devices/thermostats/ device_id /ambient_temperature_c
Devoluções	number Exemplo: 21,5
Acesso	somente leitura
Disponível em	Termostato de leitura / v1-v6 Termostato de leitura / gravação / v1-v6

umidade

Humidade, no formato por cento (%), medida no dispositivo, arredondadas para o mais próximo de 5%.

detalhes
https://developer-api.nest.com/devices/thermostats/ device_id /humidity
Devoluções	number Exemplo: 35
Alcance	0-100
Acesso	somente leitura
Disponível em	Termostato de leitura / v2-v6 Termostato de leitura / gravação / v2-v6

hvac_state

Indica se o sistema AVAC é activamente aquecimento, arrefecimento ou está desligado. Utilize este valor para indicar o estado atividade HVAC.

Quando off , o sistema de climatização não é o aquecimento ou arrefecimento de forma activa. hvac_state é independente da operação do ventilador.

detalhes
https://developer-api.nest.com/devices/thermostats/ device_id /hvac_state
Devoluções	string enum Valores: "aquecer", "arrefecimento", "desligado"
Acesso	somente leitura
Disponível em	Termostato de leitura / v3-v6 Termostato de leitura / gravação / v3-v6

where_id

Um identificador único, gerou-Nest que representa name , o nome do dispositivo de exibição.

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

detalhes
https://developer-api.nest.com/devices/thermostats/ device_id /where_id
Devoluções	string Exemplo: "d6reb_OZTM ..."
Acesso	somente leitura
Disponível em	Termostato de leitura / v4-v6 Termostato de leitura / gravação / v4-v6

está trancado

estatuto termostato Lock. Quando verdadeiro, o termostato de bloqueio função é activada, e restringe a gama de temperaturas para estes valores min / max: locked_temp_min_f , locked_temp_max_f , locked_temp_min_c , e locked_temp_max_c .

detalhes
https://developer-api.nest.com/devices/thermostats/ device_id /is_locked
Devoluções	boolean Valores: verdadeiro, falso
Acesso	somente leitura
Disponível em	Termostato de leitura / v5-v6 Termostato de leitura / gravação / v5-v6

locked_temp_min_f

Mínimo Termostato de bloqueio temperatura, indicada em graus Fahrenheit inteiras (1 ° F). Usado quando is_locked é true .

detalhes
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_min_f
Devoluções	string Exemplo: 65
Acesso	somente leitura
Disponível em	Termostato de leitura / v5-v6 Termostato de leitura / gravação / v5-v6

locked_temp_max_f

Máxima Termostato de bloqueio temperatura, indicada em graus Fahrenheit inteiras (1 ° F). Usado quando is_locked é true .

detalhes
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_max_f
Devoluções	string Exemplo: 80
Acesso	somente leitura
Disponível em	Termostato de leitura / v5-v6 Termostato de leitura / gravação / v5-v6

locked_temp_min_c

Mínimo Termostato de bloqueio temperatura, apresentado em exibido na metade graus Celsius (0,5 ° C). Usado quando is_locked é true .

detalhes
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_min_c
Devoluções	string Exemplo: 19,5
Acesso	somente leitura
Disponível em	Termostato de leitura / v5-v6 Termostato de leitura / gravação / v5-v6

locked_temp_max_c

Máxima Termostato de bloqueio temperatura, apresentado em exibido na metade graus Celsius (0,5 ° C). Usado quando is_locked é true .

detalhes
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_max_c
Devoluções	string Exemplo: 24,5
Acesso	somente leitura
Disponível em	Termostato de leitura / v5-v6 Termostato de leitura / gravação / v5-v6

rótulo

Termostato etiqueta personalizada . Aparece entre parênteses, após o nome onde.

detalhes
https://developer-api.nest.com/devices/thermostats/ device_id /label
Devoluções	string Exemplos: "Lá em cima", "Quarto de hóspedes", "Playroom"
Acesso	ler escrever
Disponível em	Ler: Termostato de leitura / v6 Termostato de leitura / gravação / v6 Escrever: Termostato de leitura / gravação / v5-v6

sunlight_correction_enabled

Protetor solar habilitado status. Usado com sunlight_correction_active . Quando true , tecnologia Protetor solar é habilitado, e o termostato é automaticamente ajustando a luz solar directa, leitura e definir a temperatura correta.

Para mais informações, consulte O que é protetor solar?

detalhes
https://developer-api.nest.com/devices/thermostats/ device_id /sunlight_correction_enabled
Devoluções	boolean Valores: verdadeiro, falso
Acesso	somente leitura
Disponível em	Termostato de leitura / v6 Termostato de leitura / gravação / v6

sunlight_correction_active

Protetor solar status ativo. Usado com sunlight_correction_enabled . Quando true , indica que o termostato está localizado na luz solar direta.

Para mais informações, consulte O que é protetor solar?

detalhes
https://developer-api.nest.com/devices/thermostats/ device_id /sunlight_correction_active
Devoluções	boolean Valores: verdadeiro, falso
Acesso	somente leitura
Disponível em	Termostato de leitura / v6 Termostato de leitura / gravação / v6

where_name

O nome de exibição do dispositivo. Associado com o termostato where_id . Pode ser qualquer nome da sala a partir de uma lista que oferecemos, ou um nome personalizado. Saiba mais sobre onde nomes para termostatos Ninho , Ninho Protege e ninho de webcams .

detalhes
https://developer-api.nest.com/devices/thermostats/ device_id /where_name
Devoluções	string Exemplo: "Corredor"
Acesso	somente leitura
Disponível em	Termostato de leitura / v6 Termostato de leitura / gravação / v6

fan_timer_duration

Especifica o período de tempo (em minutos) que o ventilador está definido para ser executado.

O fan_timer_active definição liga o ventilador. O fan_timer_timeout valor indica a hora quando fan_timer_duration é definido como fim.

Para saber como os clientes definir o temporizador do ventilador, consulte Temporizador Duração .

detalhes
https://developer-api.nest.com/devices/thermostats/ device_id /fan_timer_duration
Devoluções	int Valores: 15, 30, 45, 60, 120, 240, 480, 720
Acesso	ler escrever
Disponível em	Ler: Termostato de leitura / v6 Termostato de leitura / gravação / v6 Escrever: Termostato de leitura / gravação / v6

time_to_target

O tempo, em minutos, que levará para que a estrutura para atingir a temperatura alvo.

Veja Time-to-Temperatura para mais informações.

detalhes
https://developer-api.nest.com/devices/thermostats/ device_id /time_to_target
Devoluções	string enum Valores: "~ 0", "<5", "~ 15", "~ 90", "120"
Acesso	somente leitura
Disponível em	Termostato de leitura / v6 Termostato de leitura / gravação / v6

time_to_target_training

Quando em modo de treino, os aprende Ninho termostato sobre o sistema HVAC e descobre quanto tempo é preciso para atingir a temperatura alvo. Quando o termostato tem informações suficientes para fazer uma estimativa razoável do tempo para atingir a temperatura alvo, este valor irá mudar de training para ready .

Veja Time-to-Temperatura para mais informações.

detalhes
https://developer-api.nest.com/devices/thermostats/ device_id /time_to_target_training
Devoluções	string enum Valores: "treinamento", "pronto"
Acesso	somente leitura
Disponível em	Termostato de leitura / v6 Termostato de leitura / gravação / v6

previous_hvac_mode

Exibe a última selecionada hvac_mode . Usado quando se muda de hvac_mode = eco em um dispositivo com firmware desatualizado.

Para saber mais sobre a mudança betwen Eco e modos não-Eco, consulte o Guia do termostato .

detalhes
https://developer-api.nest.com/devices/thermostats/ device_id /previous_hvac_mode
Devoluções	string Valores: "calor", "cool", "calor-cool", "OFF", em branco (nenhum valor)
Acesso	somente leitura
Disponível em	Termostato de leitura / v6 Termostato de leitura / gravação / v6