API Smoke+CO Alarm

A API Nest funciona com todos os modelos de alarmes de fumaça e monóxido de carbono Nest ProtectTM.

Os usuários podem adicionar vários Nest Protects ao grupo devices/smoke_co_alarms, até o máximo por estrutura. Ao fazer uma chamada para esse local de dados, você pode acessar os dados do Nest Protect (valores de dados dos dispositivos na estrutura).

Todos os valores abaixo são encontrados em cada devices/smoke_co_alarms/device_id no documento JSON.

ID do dispositivo

Identificador exclusivo do Nest Protect.

Detalhes
https://developer-api.nest.com/devices/smoke_co_alarms/device_id/device_id
Retornastring
Exemplo: "RTMTKxsQTCxzVcsySOHPxKoF4OyCifrs"
Acessosomente leitura
Disponível emLeitura de Smoke+CO / v1-v5

localidade

Especifica a preferência de idioma e região (ou país).

Detalhes
https://developer-api.nest.com/devices/smoke_co_alarms/device_id/locale
Retornastring
Exemplos: "en-GB", "en-US", "es-US", "fr-CA", "fr-CA", "nl-NL"
Acessosomente leitura
Disponível emLeitura de Smoke+CO / v1-v5

versão do software

Versão do software.

Detalhes
https://developer-api.nest.com/devices/smoke_co_alarms/device_id/software_version
Retornastring
Exemplo: "1.0.1"
Acessosomente leitura
Disponível emLeitura de Smoke+CO / v1-v5

ID da estrutura

Identificador exclusivo da estrutura.

Detalhes
https://developer-api.nest.com/devices/smoke_co_alarms/device_id/structure_id
Retornastring
Exemplo: "VqFabWH21nw..."
Acessosomente leitura
Disponível emLeitura de Smoke+CO / v1-v5

nome

Nome de exibição do dispositivo. Pode ser qualquer nome de ambiente de uma lista fornecida ou um nome personalizado.

Detalhes
https://developer-api.nest.com/devices/smoke_co_alarms/device_id/name
Retornastring
Exemplo: "Hallway"
Acessosomente leitura
Disponível emLeitura de Smoke+CO / v1-v5

nome_longo

Nome de exibição longo do dispositivo. Inclui um personalizado (rótulo), criado pelo usuário ou pelo wheres.

Detalhes
https://developer-api.nest.com/devices/smoke_co_alarms/device_id/name_long
Retornastring
Exemplo: "Hallway Protect (em andares)"
Acessosomente leitura
Disponível emLeitura de Smoke+CO / v1-v5

last_connection

Carimbo de data/hora da última interação com o serviço Nest no formato ISO 8601.

Detalhes
https://developer-api.nest.com/devices/smoke_co_alarms/device_id/last_connection
Retornastring
Exemplo: "2016-12-31T23:59:59.000Z"
Acessosomente leitura
Disponível emLeitura de Smoke+CO / v1-v5

on-line

Status da conexão do dispositivo com o serviço Nest.

Detalhes
https://developer-api.nest.com/devices/smoke_co_alarms/device_id/is_online
Retornaboolean
Valores: verdadeiro, falso
Acessosomente leitura
Disponível emLeitura de Smoke+CO / v1-v5

integridade_da_bateria

Vida útil/bateria da bateria; estimativa do nível restante de energia da bateria.

Detalhes
https://developer-api.nest.com/devices/smoke_co_alarms/device_id/battery_health
Retornastring enum
Valores: "ok", "replace"
Acessosomente leitura
Disponível emLeitura de Smoke+CO / v1-v5

co_alarme_estado

Status do alarme de monóxido de carbono (CO).

Detalhes
https://developer-api.nest.com/devices/smoke_co_alarms/device_id/co_alarm_state
Retornastring enum
Valores: "ok", "warning", "emergência"
Acessosomente leitura
Disponível emLeitura de Smoke+CO / v1-v5

fumaça_alarme_estado

Status do alarme do detector de fumaça

Detalhes
https://developer-api.nest.com/devices/smoke_co_alarms/device_id/smoke_alarm_state
Retornastring enum
Valores: "ok", "warning", "emergência"
Acessosomente leitura
Disponível emLeitura de Smoke+CO / v1-v5

is_manual_test_active

Estado do teste manual do alarme de fumaça e monóxido de carbono.

Detalhes
https://developer-api.nest.com/devices/smoke_co_alarms/device_id/is_manual_test_active
Retornaboolean
Valores: verdadeiro, falso
Acessosomente leitura
Disponível emLeitura de Smoke+CO / v2-v5

último_teste_manual_

Carimbo de data/hora do último teste de alarme manual de fumaça e monóxido de carbono, no formato ISO 8601.

Detalhes
https://developer-api.nest.com/devices/smoke_co_alarms/device_id/last_manual_test_time
Retornastring
Exemplo: "2016-12-31T23:59:59.000Z"
Acessosomente leitura
Disponível emLeitura de Smoke+CO / v2-v5

estado_da_ui_cor

Indica o status do dispositivo pela cor na IU do app Nest. É uma condição agregada para estados de bateria + fumaça + CO e reflete os indicadores de cor reais exibidos no app Nest.

Para ver mais informações sobre os indicadores de cor, consulte Luzes do Nest Protect e Nível da bateria do Nest Protect.

Detalhes
https://developer-api.nest.com/devices/smoke_co_alarms/device_id/ui_color_state
Retornastring enum
Valores: "gray", "green", "yellow", "red"
Acessosomente leitura
Disponível emLeitura de Smoke+CO / v1-v5

ID do local

Um identificador exclusivo gerado pelo Nest que representa name, o nome de exibição do dispositivo.

Saiba mais sobre os nomes dos Nest Thermostats, Nest Protects e Nest Cams.

Detalhes
https://developer-api.nest.com/devices/smoke_co_alarms/device_id/where_id
Retornastring
Exemplo: "d6reb_OZTM..."
Acessosomente leitura
Disponível emLeitura de Smoke+CO / v3-v5

Nome_do_onde

O nome de exibição do dispositivo. Associados ao Nest Protect where_id. Pode ser qualquer nome de sala de uma lista que fornecemos ou um nome personalizado. Saiba mais sobre os nomes dos Nest Thermostats, Nest Protects e Nest Cams.

Detalhes
https://developer-api.nest.com/devices/smoke_co_alarms/device_id/where_name
Retornastring
Exemplo: "Hallway"
Acessosomente leitura
Disponível emLeitura de fumaça/monóxido de carbono/v5