La API de Nest funciona con todos los modelos de alarmas de humo y monóxido de carbono Nest ProtectTM.
Los usuarios pueden agregar varios Nest Protect al grupo devices/smoke_co_alarms
hasta el máximo por estructura.
Cuando realizas una llamada a esta ubicación de datos, puedes acceder a los datos del Nest Protect (valores de datos para los dispositivos en la estructura).
Los siguientes valores se encuentran en cada devices/smoke_co_alarms/device_id
del documento JSON.
id_dispositivo
Identificador único de Nest Protect
Detalles | |
---|---|
https://developer-api.nest.com/devices/smoke_co_alarms/device_id/device_id |
|
Qué muestra | string Ejemplo: RTMTKxsQTCxzVcsySOHPxKoF4OyCifrs" |
Acceso | solo lectura |
Disponible en | Lectura de humo + CO / v1-v5 |
configuración regional
Especifica la preferencia de idioma y región (o país).
Detalles | |
---|---|
https://developer-api.nest.com/devices/smoke_co_alarms/device_id/locale |
|
Qué muestra | string Ejemplos: "en-GB", "en-US", "es-US", "fr-CA", "fr-CA", "nl-NL" |
Acceso | solo lectura |
Disponible en | Lectura de humo + CO / v1-v5 |
versión_software
Versión de software.
Detalles | |
---|---|
https://developer-api.nest.com/devices/smoke_co_alarms/device_id/software_version |
|
Qué muestra | string Ejemplo: "1.0.1" |
Acceso | solo lectura |
Disponible en | Lectura de humo + CO / v1-v5 |
Estructura_id
Identificador único de la estructura.
Detalles | |
---|---|
https://developer-api.nest.com/devices/smoke_co_alarms/device_id/structure_id |
|
Qué muestra | string Ejemplo: &qtFbWH21nw... |
Acceso | solo lectura |
Disponible en | Lectura de humo + CO / v1-v5 |
name
Nombre visible 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/smoke_co_alarms/device_id/name |
|
Qué muestra | string Ejemplo: "Pasillo" |
Acceso | solo lectura |
Disponible en | Lectura de humo + CO / v1-v5 |
nombre_largo
El nombre visible completo del dispositivo. Incluye una etiqueta personalizada (etiqueta), creada por el usuario o a través de wheres
.
Detalles | |
---|---|
https://developer-api.nest.com/devices/smoke_co_alarms/device_id/name_long |
|
Qué muestra | string Ejemplo: Protect Hallway (planta alta) |
Acceso | solo lectura |
Disponible en | Lectura de humo + CO / v1-v5 |
última_conexión
Marca de tiempo de la última interacción correcta con el servicio de Nest, en formato ISO 8601.
Detalles | |
---|---|
https://developer-api.nest.com/devices/smoke_co_alarms/device_id/last_connection |
|
Qué muestra | string Ejemplo: "2016-12-31T23:59:59.000Z" |
Acceso | solo lectura |
Disponible en | Lectura de humo + CO / v1-v5 |
está_en_línea
Estado de la conexión del dispositivo con el servicio de Nest.
Detalles | |
---|---|
https://developer-api.nest.com/devices/smoke_co_alarms/device_id/is_online |
|
Qué muestra | boolean Valores: true, false |
Acceso | solo lectura |
Disponible en | Lectura de humo + CO / v1-v5 |
batería_estado
Duración de la batería y estimación del nivel restante de la batería.
Detalles | |
---|---|
https://developer-api.nest.com/devices/smoke_co_alarms/device_id/battery_health |
|
Qué muestra | string enum Valores: "ok", "replace" |
Acceso | solo lectura |
Disponible en | Lectura de humo + CO / v1-v5 |
estado_alarma
Estado de la alarma de monóxido de carbono (CO).
Detalles | |
---|---|
https://developer-api.nest.com/devices/smoke_co_alarms/device_id/co_alarm_state |
|
Qué muestra | string enum Valores: "ok", "warning", 'emergencia" |
Acceso | solo lectura |
Disponible en | Lectura de humo + CO / v1-v5 |
estado_alarma_humo
Estado de la alarma de humo.
Detalles | |
---|---|
https://developer-api.nest.com/devices/smoke_co_alarms/device_id/smoke_alarm_state |
|
Qué muestra | string enum Valores: "ok", "warning", 'emergencia" |
Acceso | solo lectura |
Disponible en | Lectura de humo + CO / v1-v5 |
is_manual_test_active
Estado de la prueba manual de la alarma de humo y monóxido de carbono.
Detalles | |
---|---|
https://developer-api.nest.com/devices/smoke_co_alarms/device_id/is_manual_test_active |
|
Qué muestra | boolean Valores: true, false |
Acceso | solo lectura |
Disponible en | Lectura de humo + CO / v2-v5 |
tiempo_prueba_último
Marca de tiempo de la última prueba manual de humo y monóxido de carbono correcta, en formato ISO 8601.
Detalles | |
---|---|
https://developer-api.nest.com/devices/smoke_co_alarms/device_id/last_manual_test_time |
|
Qué muestra | string Ejemplo: "2016-12-31T23:59:59.000Z" |
Acceso | solo lectura |
Disponible en | Lectura de humo + CO / v2-v5 |
IU_color_estado
Indica el estado del dispositivo por color en la IU de la app de Nest. Es una condición agregada para los estados de batería + humo + CO, y refleja los indicadores de color reales que se muestran en la aplicación Nest.
Para obtener más información sobre los indicadores de color, consulta Luces de Nest Protect y Nivel de batería del Nest Protect.
Detalles | |
---|---|
https://developer-api.nest.com/devices/smoke_co_alarms/device_id/ui_color_state |
|
Qué muestra | string enum Valores: gris, verde, amarillo, rojo, amarillo, &r |
Acceso | solo lectura |
Disponible en | Lectura de humo + CO / v1-v5 |
dónde_id
Un identificador único generado por Nest que representa a name
, el nombre visible del dispositivo.
Obtén más información sobre los nombres de los Nest Thermostat, los Nest Protect y las Nest Cams.
Detalles | |
---|---|
https://developer-api.nest.com/devices/smoke_co_alarms/device_id/where_id |
|
Qué muestra | string Ejemplo: "d6reb_OZTM... |
Acceso | solo lectura |
Disponible en | Lectura de humo + CO / v3-v5 |
dónde_nombre
El nombre visible del dispositivo Se asocia al Nest Protect where_id
. Puede ser cualquier nombre de habitación de una lista que proporcionamos o un nombre personalizado. Obtén más información sobre los nombres de los Nest Thermostat, los Nest Protect y las Nest Cams.
Detalles | |
---|---|
https://developer-api.nest.com/devices/smoke_co_alarms/device_id/where_name |
|
Qué muestra | string Ejemplo: "Pasillo" |
Acceso | solo lectura |
Disponible en | Lectura de humo / monóxido de carbono v5 |