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
ytarget_temperature_c
no puede ser cambiado sihvac_mode
=off
oeco
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 |