API de termostato

La API de Nest funciona con todos los modelos de Nest Learning Thermostat ™, excepto el Thermostat E con Heat Link en la UE.

Los usuarios pueden añadir varios termostatos Nest a la devices/thermostats grupo, hasta el máximo por la estructura . Cuando realiza una llamada a esta ubicación de datos, puede acceder a los datos del termostato Nest (valores de datos para dispositivos en la estructura).

Todo el debajo de los valores se encuentran bajo cada uno de devices/thermostats/ device_id en el documento JSON.

ID del dispositivo

Identificador único del termostato Nest.

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /device_id
Devoluciones	string Ejemplo: "peyiJNo0IldT2YlIVtYaGQ"
Acceso	solo lectura
Disponible en	Termostato leído / v1-v6 Termostato lectura / escritura / v1-v6

lugar

Especifica la preferencia de idioma y región (o país).

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /locale
Devoluciones	string Ejemplos: "en-GB", "en-US", "es-US", "fr-CA", "fr-CA", "nl-NL"
Acceso	solo lectura
Disponible en	Termostato leído / v1-v6 Termostato lectura / escritura / v1-v6

Versión del software

Versión del software.

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /software_version
Devoluciones	string Ejemplo: "4.0"
Acceso	solo lectura
Disponible en	Termostato leído / v1-v6 Termostato lectura / escritura / v1-v6

structure_id

Identificador único de estructura.

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /structure_id
Devoluciones	string Ejemplo: "VqFabWH21nw ..."
Acceso	solo lectura
Disponible en	Termostato leído / v1-v6 Termostato lectura / escritura / v1-v6

nombre

Muestra el nombre del dispositivo. Puede ser cualquier nombre de habitación de una lista que proporcionamos o un nombre personalizado.

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /name
Devoluciones	string Ejemplo: "Pasillo"
Acceso	solo lectura
Disponible en	Termostato leído / v1-v6 Termostato lectura / escritura / v1-v6

name_long

Nombre de visualización largo del dispositivo. Incluye una costumbre (etiqueta), creado por el usuario, o por medio de wheres .

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /name_long
Devoluciones	string Ejemplo: "Termostato de pasillo (piso de arriba)"
Acceso	solo lectura
Disponible en	Termostato leído / v1-v6 Termostato lectura / escritura / v1-v6

last_connection

Marca de tiempo de la última interacción exitosa con el servicio Nido, en la norma ISO 8601 de formato.

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /last_connection
Devoluciones	string Ejemplo: "2016-12-31T23: 59: 59.000Z"
Acceso	solo lectura
Disponible en	Termostato leído / v1-v6 Termostato lectura / escritura / v1-v6

está en linea

Estado de conexión del dispositivo con el servicio Nest.

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /is_online
Devoluciones	boolean Valores: verdadero, falso
Acceso	solo lectura
Disponible en	Termostato leído / v1-v6 Termostato lectura / escritura / v1-v6

can_cool

Capacidad del sistema para enfriar (tiene aire acondicionado).

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /can_cool
Devoluciones	boolean Valores: verdadero, falso
Acceso	solo lectura
Disponible en	Termostato leído / v1-v6 Termostato lectura / escritura / v1-v6

can_heat

Capacidad del sistema para calentar.

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /can_heat
Devoluciones	boolean Valores: verdadero, falso
Acceso	solo lectura
Disponible en	Termostato leído / v1-v6 Termostato lectura / escritura / v1-v6

is_using_emergency_heat

Estado de calefacción de emergencia en sistemas con bombas de calor para refrigeración.

Cuando la calefacción de emergencia está encendida:

• El usuario puede ajustar la temperatura objetivo en el dispositivo, pero no puede cambiar el modo hasta que se apague la calefacción de emergencia.
• El hvac_mode todavía se puede cambiar a través de la API

Ver de qué calefacción de emergencia? para obtener más información sobre cómo el termostato Nest es compatible con la calefacción de emergencia.

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /is_using_emergency_heat
Devoluciones	boolean Valores: verdadero, falso
Acceso	solo lectura
Disponible en	Termostato leído / v1-v6 Termostato lectura / escritura / v1-v6

has_fan

Capacidad del sistema para controlar el ventilador independientemente de la calefacción o la refrigeración.

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /has_fan
Devoluciones	boolean Valores: verdadero, falso
Acceso	solo lectura
Disponible en	Termostato leído / v1-v6 Termostato lectura / escritura / v1-v6

fan_timer_active

Indica si el temporizador del ventilador está activado; se utiliza con fan_timer_duration para encender el ventilador para una duración predeterminada (especificada por el usuario).

Ver Fan Control Avanzado para más información sobre cómo los clientes establecen la duración del ventilador.

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /fan_timer_active
Devoluciones	boolean Valores: verdadero, falso
Acceso	leer escribir
Disponible en	Termostato leído / v1-v6 Termostato lectura / escritura / v1-v6

fan_timer_timeout

Marca de tiempo que muestra cuando el temporizador del ventilador llega a 0 (tiempo de parada), en la norma ISO 8601 de formato.

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /fan_timer_timeout
Devoluciones	string Ejemplo: "2016-12-31T23: 59: 59.000Z"
Acceso	solo lectura
Disponible en	Termostato leído / v1-v6 Termostato lectura / escritura / v1-v6

has_leaf

Aparece cuando el termostato está configurado en una temperatura de ahorro de energía.

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /has_leaf
Devoluciones	boolean Valores: verdadero, falso
Acceso	solo lectura
Disponible en	Termostato leído / v1-v6 Termostato lectura / escritura / v1-v6

la escala de temperatura

Fahrenheit o Celsius; utilizado con pantalla de temperatura.

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /temperature_scale
Devoluciones	string enum Valores: "F", "C"
Acceso	leer escribir
Disponible en	Leer: Termostato leído / v1-v6 Termostato lectura / escritura / v1-v6 Escribir: Termostato lectura / escritura / v5-v6

target_temperature_f

Temperatura deseada, en grados Fahrenheit completos (1 ° F). Se utiliza cuando hvac_mode = heat o cool .

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_f
Devoluciones	number Ejemplo: 72
Distancia	50-90
Acceso	leer escribir
Disponible en	Termostato leído / v1-v6 Termostato lectura / escritura / v1-v6

target_temperature_c

Temperatura deseada, en medio grado Celsius (0,5 ° C). Se utiliza cuando hvac_mode = heat o cool .

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_c
Devoluciones	number Ejemplo: 21,5
Distancia	9-32
Acceso	leer escribir
Disponible en	Termostato leído / v1-v6 Termostato lectura / escritura / v1-v6

target_temperature_high_f

Temperatura objetivo máxima, mostrada en grados Fahrenheit enteros (1 ° F). Cuando se utiliza hvac_mode = heat-cool (modo Calor • Frío).

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_high_f
Devoluciones	number Ejemplo: 80
Acceso	leer escribir
Disponible en	Termostato leído / v1-v6 Termostato lectura / escritura / v1-v6

target_temperature_high_c

Temperatura objetivo máxima, mostrada en medio grado Celsius (0,5 ° C). Cuando se utiliza hvac_mode = heat-cool (modo Calor • Frío).

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_high_c
Devoluciones	number Ejemplo: 24,5
Acceso	leer escribir
Disponible en	Termostato leído / v1-v6 Termostato lectura / escritura / v1-v6

target_temperature_low_f

Temperatura objetivo mínima, mostrada en grados Fahrenheit (1 ° F) enteros. Cuando se utiliza hvac_mode = heat-cool (modo Calor • Frío).

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_low_f
Devoluciones	number Ejemplo: 65
Acceso	leer escribir
Disponible en	Termostato leído / v1-v6 Termostato lectura / escritura / v1-v6

target_temperature_low_c

Temperatura objetivo mínima, mostrada en medio grado Celsius (0,5 ° C). Cuando se utiliza hvac_mode = heat-cool (modo Calor • Frío).

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /target_temperature_low_c
Devoluciones	number Ejemplo: 19,5
Acceso	leer escribir
Disponible en	Termostato leído / v1-v6 Termostato lectura / escritura / v1-v6

eco_temperature_high_f

Temperatura Eco máxima, que se muestra en grados Fahrenheit (1 ° F) completos. Se utiliza cuando hvac_mode = eco .

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_high_f
Devoluciones	number Ejemplo: 80
Acceso	solo lectura
Disponible en	Termostato leído / v6 Termostato lectura / escritura / v6

eco_temperature_high_c

Temperatura Eco máxima, que se muestra en medio grado Celsius (0,5 ° C). Se utiliza cuando hvac_mode = eco .

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_high_c
Devoluciones	number Ejemplo: 24,5
Acceso	solo lectura
Disponible en	Termostato leído / v6 Termostato lectura / escritura / v6

eco_temperature_low_f

Temperatura ecológica mínima, que se muestra en grados Fahrenheit (1 ° F) completos. Se utiliza cuando hvac_mode = eco .

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_low_f
Devoluciones	number Ejemplo: 65
Acceso	solo lectura
Disponible en	Termostato leído / v6 Termostato lectura / escritura / v6

eco_temperature_low_c

Temperatura ecológica mínima, que se muestra en medio grado Celsius (0,5 ° C). Se utiliza cuando hvac_mode = eco .

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /eco_temperature_low_c
Devoluciones	number Ejemplo: 19,5
Acceso	solo lectura
Disponible en	Termostato leído / v6 Termostato lectura / escritura / v6

away_temperature_high_f (ANULADO)

Temperatura máxima de salida, mostrada en grados Fahrenheit completos (1 ° F).

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_high_f
Devoluciones	number Ejemplo: 80
Acceso	solo lectura
Disponible en	Termostato leído / v1-v6 Termostato lectura / escritura / v1-v6

away_temperature_high_c (ANULADO)

Temperatura máxima de salida, mostrada en medio grado Celsius (0,5 ° C).

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_high_c
Devoluciones	number Ejemplo: 24,5
Acceso	solo lectura
Disponible en	Termostato leído / v1-v6 Termostato lectura / escritura / v1-v6

away_temperature_low_f (ANULADO)

Temperatura mínima de salida, mostrada en grados Fahrenheit (1 ° F) enteros.

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_low_f
Devoluciones	number Ejemplo: 65
Acceso	solo lectura
Disponible en	Termostato leído / v1-v6 Termostato lectura / escritura / v1-v6

away_temperature_low_c (ANULADO)

Temperatura mínima de salida, mostrada en medio grado Celsius (0,5 ° C).

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /away_temperature_low_c
Devoluciones	number Ejemplo: 19,5
Acceso	solo lectura
Disponible en	Termostato leído / v1-v6 Termostato lectura / escritura / v1-v6

hvac_mode

Indica los modos de calefacción / refrigeración del sistema HVAC, como Heat • Cool para sistemas con capacidad de calefacción y refrigeración, o Temperaturas Eco para ahorrar energía.

• hvac_mode se puede cambiar si el termostato está bloqueado
• target_temperature_f y target_temperature_c no puede ser cambiado si hvac_mode = off o eco

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /hvac_mode
Devoluciones	string enum Valores: "calor", "frío", "calor-frío", "eco", "apagado"
Acceso	leer escribir
Disponible en	Termostato leído / v1-v6 Termostato lectura / escritura / v1-v6

temperatura_ambiente_f

Temperatura, medida en el dispositivo, en grados Fahrenheit (1 ° F) enteros.

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /ambient_temperature_f
Devoluciones	number Ejemplo: 72
Acceso	solo lectura
Disponible en	Termostato leído / v1-v6 Termostato lectura / escritura / v1-v6

temperatura_ambiente_c

Temperatura, medida en el dispositivo, en medio grado Celsius (0,5 ° C).

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /ambient_temperature_c
Devoluciones	number Ejemplo: 21,5
Acceso	solo lectura
Disponible en	Termostato leído / v1-v6 Termostato lectura / escritura / v1-v6

humedad

Humedad, en formato de porcentaje (%), medida en el dispositivo, redondeada al 5% más cercano.

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /humidity
Devoluciones	number Ejemplo: 35
Distancia	0-100
Acceso	solo lectura
Disponible en	Termostato leído / v2-v6 Termostato lectura / escritura / v2-v6

hvac_state

Indica si el sistema HVAC está calentando, enfriando o apagando activamente. Utilice este valor para indicar el estado de actividad de HVAC.

Cuando off , el sistema de HVAC no se está calentando o enfriando activamente. hvac_state es independiente del funcionamiento del ventilador.

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /hvac_state
Devoluciones	string enum Valores: "calefacción", "refrigeración", "apagado"
Acceso	solo lectura
Disponible en	Termostato leído / v3-v6 Termostato lectura / escritura / v3-v6

where_id

Un identificador único, generado Nest-que representa name , el nombre de visualización del dispositivo.

Más información sobre dónde nombres para termostatos Nest , Nido Protege y Nido de levas .

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /where_id
Devoluciones	string Ejemplo: "d6reb_OZTM ..."
Acceso	solo lectura
Disponible en	Termostato leído / v4-v6 Termostato lectura / escritura / v4-v6

está bloqueado

Estado de bloqueo del termostato. Cuando cierto, el termostato Lock función está activada, y restringe el intervalo de temperatura a estos valores mín / máx: locked_temp_min_f , locked_temp_max_f , locked_temp_min_c , y locked_temp_max_c .

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /is_locked
Devoluciones	boolean Valores: verdadero, falso
Acceso	solo lectura
Disponible en	Termostato leído / v5-v6 Termostato lectura / escritura / v5-v6

lock_temp_min_f

Mínimo termostato Lock temperatura, que se muestra en grados enteros Fahrenheit (1 ° F). Se utiliza cuando is_locked es true .

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_min_f
Devoluciones	string Ejemplo: 65
Acceso	solo lectura
Disponible en	Termostato leído / v5-v6 Termostato lectura / escritura / v5-v6

lock_temp_max_f

Máxima termostato Lock temperatura, que se muestra en grados enteros Fahrenheit (1 ° F). Se utiliza cuando is_locked es true .

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_max_f
Devoluciones	string Ejemplo: 80
Acceso	solo lectura
Disponible en	Termostato leído / v5-v6 Termostato lectura / escritura / v5-v6

lock_temp_min_c

Mínimo termostato Lock temperatura, representada en que se muestra en la mitad de grados Celsius (0,5 ° C). Se utiliza cuando is_locked es true .

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_min_c
Devoluciones	string Ejemplo: 19,5
Acceso	solo lectura
Disponible en	Termostato leído / v5-v6 Termostato lectura / escritura / v5-v6

lock_temp_max_c

Máxima termostato Lock temperatura, representada en que se muestra en la mitad de grados Celsius (0,5 ° C). Se utiliza cuando is_locked es true .

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /locked_temp_max_c
Devoluciones	string Ejemplo: 24,5
Acceso	solo lectura
Disponible en	Termostato leído / v5-v6 Termostato lectura / escritura / v5-v6

etiqueta

Termostato de etiqueta personalizada . Aparece entre paréntesis, después del nombre where.

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /label
Devoluciones	string Ejemplos: "Arriba", "Habitación de invitados", "Sala de juegos"
Acceso	leer escribir
Disponible en	Leer: Termostato leído / v6 Termostato lectura / escritura / v6 Escribir: Termostato lectura / escritura / v5-v6

luz del sol_corrección_enabled

Estado de bloqueador solar habilitado. Se utiliza con sunlight_correction_active . Cuando true , la tecnología Bloqueador solar está habilitado, y el termostato está regulando automáticamente a la luz solar directa, la lectura y ajuste de la temperatura correcta.

Para obtener más información, consulte ¿Qué es el bloqueador solar?

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /sunlight_correction_enabled
Devoluciones	boolean Valores: verdadero, falso
Acceso	solo lectura
Disponible en	Termostato leído / v6 Termostato lectura / escritura / v6

luz_del_correccion_activa

Estado activo de bloqueador solar. Se utiliza con sunlight_correction_enabled . Cuando true , indica que el termostato se encuentra en la luz solar directa.

Para obtener más información, consulte ¿Qué es el bloqueador solar?

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /sunlight_correction_active
Devoluciones	boolean Valores: verdadero, falso
Acceso	solo lectura
Disponible en	Termostato leído / v6 Termostato lectura / escritura / v6

where_name

El nombre para mostrar del dispositivo. Asociado con el termostato where_id . Puede ser cualquier nombre de habitación de una lista que proporcionamos o un nombre personalizado. Más información sobre dónde nombres para termostatos Nest , Nido Protege y Nido de levas .

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /where_name
Devoluciones	string Ejemplo: "Pasillo"
Acceso	solo lectura
Disponible en	Termostato leído / v6 Termostato lectura / escritura / v6

fan_timer_duration

Especifica el tiempo (en minutos) que el ventilador está configurado para funcionar.

El fan_timer_active ajuste se enciende el ventilador. El fan_timer_timeout valor indica la marca de tiempo cuando fan_timer_duration se establece a extremo.

Para aprender cómo los clientes ajustar el temporizador del ventilador, ver la duración del temporizador .

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /fan_timer_duration
Devoluciones	int Valores: 15, 30, 45, 60, 120, 240, 480, 720
Acceso	leer escribir
Disponible en	Leer: Termostato leído / v6 Termostato lectura / escritura / v6 Escribir: Termostato lectura / escritura / v6

time_to_target

El tiempo, en minutos, que le tomará a la estructura alcanzar la temperatura objetivo.

Ver Time-to-temperatura para obtener más información.

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /time_to_target
Devoluciones	string enum Valores: "~ 0", "<5", "~ 15", "~ 90", "120"
Acceso	solo lectura
Disponible en	Termostato leído / v6 Termostato lectura / escritura / v6

time_to_target_training

Cuando está en modo de entrenamiento, el termostato Nest aprende sobre el sistema HVAC y descubre cuánto tiempo lleva alcanzar la temperatura objetivo. Cuando el termostato tiene suficiente información para hacer una estimación razonable del tiempo para alcanzar la temperatura deseada, este valor cambiará de training a ready .

Ver Time-to-temperatura para obtener más información.

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /time_to_target_training
Devoluciones	string enum Valores: "formación", "listo"
Acceso	solo lectura
Disponible en	Termostato leído / v6 Termostato lectura / escritura / v6

previous_hvac_mode

Muestra seleccionado el último hvac_mode . Se utiliza cuando se cambia de hvac_mode = eco en un dispositivo con firmware anticuado.

Para obtener más información acerca de cambiar Transcurrirá modos no-Eco Eco y, consulte la Guía del termostato .

Detalles
https://developer-api.nest.com/devices/thermostats/ device_id /previous_hvac_mode
Devoluciones	string Valores: "calor", "frío", "calor-frío", "desactivado", en blanco (sin valor)
Acceso	solo lectura
Disponible en	Termostato leído / v6 Termostato lectura / escritura / v6