API de alarma de humo + CO

La API de Nest funciona con todos los modelos de alarmas de humo y monóxido de carbono Nest Protect ™.

Los usuarios pueden añadir múltiples Nido Protege a la devices/smoke_co_alarms grupo, hasta el máximo por la estructura . Cuando realiza una llamada a esta ubicación de datos, puede acceder a los datos de Nest Protect (valores de datos para dispositivos en la estructura).

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

ID del dispositivo

Identificador único de Nest Protect.

Detalles
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /device_id
Devoluciones	string Ejemplo: "RTMTKxsQTCxzVcsySOHPxKoF4OyCifrs"
Acceso	solo lectura
Disponible en	Lectura de humo + CO / v1-v5

lugar

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

Detalles
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /locale
Devoluciones	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 del software

Versión del software.

Detalles
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /software_version
Devoluciones	string Ejemplo: "1.0.1"
Acceso	solo lectura
Disponible en	Lectura de humo + CO / v1-v5

structure_id

Identificador único de estructura.

Detalles
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /structure_id
Devoluciones	string Ejemplo: "VqFabWH21nw ..."
Acceso	solo lectura
Disponible en	Lectura de humo + CO / v1-v5

nombre

Nombre para mostrar 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
Devoluciones	string Ejemplo: "Pasillo"
Acceso	solo lectura
Disponible en	Lectura de humo + CO / v1-v5

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/smoke_co_alarms/ device_id /name_long
Devoluciones	string Ejemplo: "Hallway Protect (arriba)"
Acceso	solo lectura
Disponible en	Lectura de humo + CO / v1-v5

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/smoke_co_alarms/ device_id /last_connection
Devoluciones	string Ejemplo: "2016-12-31T23: 59: 59.000Z"
Acceso	solo lectura
Disponible en	Lectura de humo + CO / v1-v5

está en linea

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

Detalles
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /is_online
Devoluciones	boolean Valores: verdadero, falso
Acceso	solo lectura
Disponible en	Lectura de humo + CO / v1-v5

battery_health

Vida / salud de la batería; estimación del nivel de carga restante de la batería.

Detalles
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /battery_health
Devoluciones	string enum Valores: "ok", "reemplazar"
Acceso	solo lectura
Disponible en	Lectura de humo + CO / v1-v5

co_alarm_state

Estado de alarma de monóxido de carbono (CO).

Detalles
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /co_alarm_state
Devoluciones	string enum Valores: "ok", "advertencia", "emergencia"
Acceso	solo lectura
Disponible en	Lectura de humo + CO / v1-v5

Smoke_alarm_state

Estado de alarma de humo.

Detalles
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /smoke_alarm_state
Devoluciones	string enum Valores: "ok", "advertencia", "emergencia"
Acceso	solo lectura
Disponible en	Lectura de humo + CO / v1-v5

is_manual_test_active

Estado de la prueba manual de alarma de humo y CO.

Detalles
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /is_manual_test_active
Devoluciones	boolean Valores: verdadero, falso
Acceso	solo lectura
Disponible en	Lectura de humo + CO / v2-v5

last_manual_test_time

Marca de tiempo de la última prueba de humo y CO alarma manual con éxito, en la norma ISO 8601 de formato.

Detalles
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /last_manual_test_time
Devoluciones	string Ejemplo: "2016-12-31T23: 59: 59.000Z"
Acceso	solo lectura
Disponible en	Lectura de humo + CO / v2-v5

ui_color_state

Indica el estado del dispositivo por color en la interfaz de usuario de la aplicación 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, consulte Nest luces Proteger y nivel de batería Proteger el nido .

Detalles
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /ui_color_state
Devoluciones	string enum Valores: "gris", "verde", "amarillo", "rojo"
Acceso	solo lectura
Disponible en	Lectura de humo + CO / v1-v5

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/smoke_co_alarms/ device_id /where_id
Devoluciones	string Ejemplo: "d6reb_OZTM ..."
Acceso	solo lectura
Disponible en	Lectura de humo + CO / v3-v5

where_name

El nombre para mostrar del dispositivo. Asociado con el Nest Protect 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/smoke_co_alarms/ device_id /where_name
Devoluciones	string Ejemplo: "Pasillo"
Acceso	solo lectura
Disponible en	Lectura de humo + CO / v5