API de Alarma de humo y monóxido de carbono

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