Notice: We're retiring Works with Nest. See the home page for more information.
Google se compromete a impulsar la igualdad racial para las comunidades afrodescendientes. Obtén información al respecto.
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