La API Nido funciona con todos los modelos de alarmas de monóxido de Nest Protect ™ + humo de carbono.
Los usuarios pueden añadir múltiples Nido Protege a la devices/smoke_co_alarms grupo, hasta el máximo por la estructura . Cuando se realiza una llamada a esta ubicación de los datos, puede acceder a los datos Nido 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
Nest Protect identificador único.
| detalles | |
|---|---|
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /device_id | |
| Devoluciones | string Ejemplo: "RTMTKxsQTCxzVcsySOHPxKoF4OyCifrs" |
| Acceso | solo lectura |
| Disponible en | Humo + CO lectura / V1-V5 |
lugar
Especifica idioma y la región (o país) preferencia.
| detalles | |
|---|---|
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /locale | |
| Devoluciones | string Ejemplos: "en-GB", "en-US", "es-nos", "fr-CA", "fr-CA", "nl-NL" |
| Acceso | solo lectura |
| Disponible en | Humo + CO lectura / 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 | Humo + CO lectura / V1-V5 |
structure_id
Estructurar identificador único.
| detalles | |
|---|---|
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /structure_id | |
| Devoluciones | string Ejemplo: "VqFabWH21nw ..." |
| Acceso | solo lectura |
| Disponible en | Humo + CO lectura / V1-V5 |
nombre
Visualización Nombre del dispositivo; puede ser cualquier nombre de la sala 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 | Humo + CO lectura / V1-V5 |
NAME_LONG
nombre para mostrar 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: "Pasillo Protect (arriba)" |
| Acceso | solo lectura |
| Disponible en | Humo + CO lectura / 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 | Humo + CO lectura / V1-V5 |
está en linea
el estado de conexión del dispositivo con el servicio de 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 | Humo + CO lectura / V1-V5 |
battery_health
Duración de la batería / de la salud; estimación del nivel restante de la energía 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 | Humo + CO lectura / V1-V5 |
co_alarm_state
El monóxido de carbono (CO) de estado de alarma.
| detalles | |
|---|---|
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /co_alarm_state | |
| Devoluciones | string enum Valores: "ok", "aviso", "emergencia" |
| Acceso | solo lectura |
| Disponible en | Humo + CO lectura / V1-V5 |
smoke_alarm_state
El humo estado de alarma.
| detalles | |
|---|---|
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /smoke_alarm_state | |
| Devoluciones | string enum Valores: "ok", "aviso", "emergencia" |
| Acceso | solo lectura |
| Disponible en | Humo + CO lectura / V1-V5 |
is_manual_test_active
Estado del humo manual y prueba de alarma de 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 | Humo + CO lectura / 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 | Humo + CO lectura / v2-v5 |
ui_color_state
Indica el estado del dispositivo por el color de la interfaz de usuario de aplicación de Nest. Es una condición agregada de los estados de la batería + CO + humo, y refleja los indicadores de color reales que aparecen 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 | Humo + CO lectura / 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 | Humo + CO lectura / v3-v5 |
where_name
El nombre de visualización del dispositivo. Asociado con el Nest Protect where_id . Puede ser cualquier nombre de la sala 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 | Humo + CO lectura / v5 |