Google se compromete a promover la equidad racial para las comunidades negras. Ver cómo.
Se usó la API de Cloud Translation para traducir esta página.
Switch to English

API de alarma de humo + CO

Nest API funciona con todos los modelos de alarma de humo + monóxido de carbono Nest Protect ™.

Los usuarios pueden agregar múltiples Nest Protects al grupo de devices/smoke_co_alarms , hasta el máximo por 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).

Todos los valores a continuación se encuentran debajo de cada 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 Smoke + CO read / v1-v5

lugar

Especifica el idioma y la preferencia de 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 Smoke + CO read / 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 Smoke + CO read / v1-v5

estructura_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 Smoke + CO read / v1-v5

nombre

Nombre para mostrar del dispositivo; puede ser cualquier nombre de 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 Smoke + CO read / v1-v5

nombre_largo

Nombre largo para mostrar del dispositivo. Incluye una (etiqueta) personalizada, creada por el usuario, o vía wheres .

Detalles
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /name_long
Devoluciones string
Ejemplo: "Protección de pasillo (arriba)"
Acceso solo lectura
Disponible en Smoke + CO read / v1-v5

última_conexión

Marca de tiempo de la última interacción exitosa con el servicio Nest, en formato ISO 8601 .

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 Smoke + CO read / 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 Smoke + CO read / v1-v5

batería_salud

Duración de la batería / salud; Estimación del nivel de batería restante.

Detalles
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /battery_health
Devoluciones string enum
Valores: "ok", "replace"
Acceso solo lectura
Disponible en Smoke + CO read / 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 Smoke + CO read / v1-v5

humo_alarma_estado

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 Smoke + CO read / v1-v5

is_manual_test_active

Estado de la prueba de alarma manual 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 Smoke + CO read / v2-v5

last_manual_test_time

Marca de tiempo de la última prueba de alarma de humo y CO manual exitosa, en formato ISO 8601 .

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 Smoke + CO read / 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 Luces de Nest Protect y nivel de batería de Nest Protect .

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 Smoke + CO read / v1-v5

where_id

Un identificador único generado por Nest que representa el name , el nombre para mostrar del dispositivo.

Obtén más información sobre dónde están los nombres de los termostatos Nest , Nest Protects y Nest Cams .

Detalles
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /where_id
Devoluciones string
Ejemplo: "d6reb_OZTM ..."
Acceso solo lectura
Disponible en Smoke + CO read / v3-v5

donde_nombre

El nombre para mostrar del dispositivo. Asociado con el Nest Protect where_id . Puede ser cualquier nombre de sala de una lista que proporcionamos, o un nombre personalizado. Obtén más información sobre dónde están los nombres de los termostatos Nest , Nest Protects y Nest Cams .

Detalles
https://developer-api.nest.com/devices/smoke_co_alarms/ device_id /where_name
Devoluciones string
Ejemplo: "Pasillo"
Acceso solo lectura
Disponible en Smoke + CO read / v5