Camera API

A API Nest funciona com todos os modelos Nest Cam ™.

Os usuários podem adicionar vários Nest cames à devices/cameras grupo, até o máximo por estrutura . Quando você faz uma chamada para este local de dados, você pode acessar dados a Nest Cam (valores de dados para dispositivos na estrutura).

Toda a seguir os valores são encontrados em cada devices/cameras/ device_id no documento JSON.

ID de dispositivo

Nest Cam identificador único.

detalhes
`https://developer-api.nest.com/devices/cameras/ device_id /device_id`
Devoluções	`string` Exemplo: "awJo6rH ..."
Acesso	somente leitura
Disponível em	Câmera de leitura / v1-v3 Camera leia + images / v1-v4 Câmera de leitura / gravação / v1-v3 Câmera de leitura / gravação + images / v1-v4

versão do software

Versão do software.

detalhes
`https://developer-api.nest.com/devices/cameras/ device_id /software_version`
Devoluções	`string` Exemplo: "4.0"
Acesso	somente leitura
Disponível em	Câmera de leitura / v1-v3 Camera leia + images / v1-v4 Câmera de leitura / gravação / v1-v3 Câmera de leitura / gravação + images / v1-v4

structure_id

Estruturar identificador único.

detalhes
`https://developer-api.nest.com/devices/cameras/ device_id /structure_id`
Devoluções	`string` Exemplo: "VqFabWH21nw ..."
Acesso	somente leitura
Disponível em	Câmera de leitura / v1-v3 Camera leia + images / v1-v4 Câmera de leitura / gravação / v1-v3 Câmera de leitura / gravação + images / v1-v4

where_id

Um identificador único, gerou-Nest que representa name , o nome do dispositivo de exibição.

Saiba mais sobre onde nomes para termostatos Ninho , Ninho Protege e ninho de webcams .

detalhes
`https://developer-api.nest.com/devices/cameras/ device_id /where_id`
Devoluções	`string` Exemplo: "d6reb_OZTM ..."
Acesso	somente leitura
Disponível em	Câmera de leitura / v1-v3 Camera leia + images / v1-v4 Câmera de leitura / gravação / v1-v3 Câmera de leitura / gravação + images / v1-v4

where_name

O nome de exibição do dispositivo. Associado com o Cam Nest where_id . Pode ser qualquer nome da sala a partir de uma lista que oferecemos, ou um nome personalizado. Saiba mais sobre onde nomes para termostatos Ninho , Ninho Protege e ninho de webcams .

detalhes
`https://developer-api.nest.com/devices/cameras/ device_id /where_name`
Devoluções	`string` Exemplo: "Corredor"
Acesso	somente leitura
Disponível em	Câmera de leitura / v3 Camera leia + images / v4 Câmera de leitura / gravação / v3 Câmera de leitura / gravação + images / v4

nome

Exibir o nome do dispositivo; Pode ser qualquer nome quarto de uma lista que oferecemos, ou um nome personalizado.

detalhes
`https://developer-api.nest.com/devices/cameras/ device_id /name`
Devoluções	`string` Exemplo: "Corredor"
Acesso	somente leitura
Disponível em	Câmera de leitura / v1-v3 Camera leia + images / v1-v4 Câmera de leitura / gravação / v1-v3 Câmera de leitura / gravação + images / v1-v4

NAME_LONG

nome de exibição longo do dispositivo. Inclui um personalizado (etiqueta), criado pelo usuário, ou através wheres .

detalhes
`https://developer-api.nest.com/devices/cameras/ device_id /name_long`
Devoluções	`string` Exemplo: "Corredor Nest Cam (em cima)"
Acesso	somente leitura
Disponível em	Câmera de leitura / v1-v3 Camera leia + images / v1-v4 Câmera de leitura / gravação / v1-v3 Câmera de leitura / gravação + images / v1-v4

está online

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

detalhes
`https://developer-api.nest.com/devices/cameras/ device_id /is_online`
Devoluções	`boolean` Valores: verdadeiro, falso
Acesso	somente leitura
Disponível em	Câmera de leitura / v1-v3 Camera leia + images / v1-v4 Câmera de leitura / gravação / v1-v3 Câmera de leitura / gravação + images / v1-v4

is_streaming

estado da câmara, quer por e streaming de vídeo ativamente, ou desligado. Veja Como sua câmera funciona com Casa / Fora Assist para mais informações.

detalhes
`https://developer-api.nest.com/devices/cameras/ device_id /is_streaming`
Devoluções	`boolean` Valores: verdadeiro, falso
Acesso	ler escrever
Disponível em	Câmera de leitura / v1-v3 Camera leia + images / v1-v4 Câmera de leitura / gravação / v1-v3 Câmera de leitura / gravação + images / v1-v4

is_audio_input_enabled

estatuto microfone da câmara, quer por e ouvir, ou desligado. Saiba mais sobre as configurações de áudio a Nest Cam .

detalhes
`https://developer-api.nest.com/devices/cameras/ device_id /is_audio_input_enabled`
Devoluções	`boolean` Valores: verdadeiro, falso
Acesso	somente leitura
Disponível em	Câmera de leitura / v1-v3 Camera leia + images / v1-v4 Câmera de leitura / gravação / v1-v3 Câmera de leitura / gravação + images / v1-v4

last_is_online_change

Timestamp que identifica a última alteração do status online, em ISO 8601 formato.

detalhes
`https://developer-api.nest.com/devices/cameras/ device_id /last_is_online_change`
Devoluções	`string` Exemplo: "2016-12-29T18: 42: 00.000Z"
Acesso	somente leitura
Disponível em	Câmera de leitura / v1-v3 Camera leia + images / v1-v4 Câmera de leitura / gravação / v1-v3 Câmera de leitura / gravação + images / v1-v4

is_video_history_enabled

Nest Aware status da assinatura (assinatura ativa ou não).

detalhes
`https://developer-api.nest.com/devices/cameras/ device_id /is_video_history_enabled`
Devoluções	`boolean` Valores: verdadeiro, falso
Acesso	somente leitura
Disponível em	Câmera de leitura / v1-v3 Camera leia + images / v1-v4 Câmera de leitura / gravação / v1-v3 Câmera de leitura / gravação + images / v1-v4

web_url

Web URL (link profundo) para o fluxo de vídeo ao vivo em home.nest.com .

detalhes
`https://developer-api.nest.com/devices/cameras/ device_id /web_url`
Devoluções	`string` Exemplo: " `https://home.nest.com/cameras/ device_id ?auth= camera_token` "
Acesso	somente leitura
Disponível em	Câmera de leitura / v1-v3 Camera leia + images / v1-v4 Câmera de leitura / gravação / v1-v3 Câmera de leitura / gravação + images / v1-v4

APP_URL

App URL (link profundo) para o fluxo de vídeo ao vivo no app Nest.

detalhes
`https://developer-api.nest.com/devices/cameras/ device_id /app_url`
Devoluções	`string` Exemplo: " `nestmobile://cameras/ device_id ?auth= camera_token` "
Acesso	somente leitura
Disponível em	Câmera de leitura / v1-v3 Camera leia + images / v1-v4 Câmera de leitura / gravação / v1-v3 Câmera de leitura / gravação + images / v1-v4

is_public_share_enabled

Os usuários podem optar por compartilhar seus vídeos e torná-lo visível por qualquer pessoa. Quando a participação pública é ativada, você pode ler public_share_url .

detalhes
`https://developer-api.nest.com/devices/cameras/ device_id /is_public_share_enabled`
Devoluções	`boolean` Valores: verdadeiro, falso
Acesso	somente leitura
Disponível em	Camera leia + images / v3-v4 Câmera de leitura / gravação + images / v3-v4

activity_zones

Retorna uma matriz de todas as Zonas actividade definida.

Zonas de atividade são usados para monitorar eventos de movimento dentro das áreas definidas pelo usuário do fluxo de vídeo. Requer Nest Aware .

detalhes
`https://developer-api.nest.com/devices/cameras/ device_id /activity_zones`
Devoluções	`array` Exemplo: `[ {"name" : " string1 ", "id" : " string2 "},... ]` • `string1` é o nome da zona, um ou automaticamente gerado quando a zona é criada definido pelo utilizador. • `string2` é um identificador atribuído pela Nest quando a Zona Atividade é criado.
Acesso	somente leitura
Disponível em	Camera leia + images / v3-v4 Câmera de leitura / gravação + images / v3-v4

public_share_url

Pode aceder a este URL quando um usuário faz o seu público fluxo de vídeo .

detalhes
`https://developer-api.nest.com/devices/cameras/ device_id /public_share_url`
Devoluções	`string` Exemplo: " `https://video.nest.com/live/ string1 ? string2` " `string1` é o nome do fluxo de vídeo, um ou gerado automaticamente quando o fluxo é definido como público definido pelo usuário. Cuidado: `string2` é usado para fazer a chamada de API. Não altere a corda ou a chamada falhará.
Acesso	somente leitura
Disponível em	Camera leia + images / v3-v4 Câmera de leitura / gravação + images / v3-v4

SNAPSHOT_URL

Capturar uma imagem sob demanda. Retorna o URL de uma imagem capturada do fluxo de vídeo ao vivo. Exige que a câmera estiver ligada e streaming ativamente.

Utilize este campo para obter um instantâneo do fluxo de vídeo ao vivo.

snapshot_url - retorna a URL de uma imagem capturada do fluxo de vídeo ao vivo
Exige que a câmera estiver ligada e streaming ativamente

A qualidade instantâneo da API só é 1080p rendimento se você é:

visualizar ativamente o fluxo de câmera na aplicação ( web_url )
visualizar ativamente o fluxo de público ( app_url )
subscrito Nest Aware

Se você não está vendo ativamente o fluxo ou não tem uma assinatura Ciente Nest, a API não tem 1080p fonte da qual recuperar um instantâneo com essa resolução e gera uma imagem de qualidade inferior. Além disso, a baixa largura de banda de rede local pode causar a resolução API instantâneo para mergulhar abaixo 1080p com Ninho presente Aware.

Saiba mais sobre os requisitos de largura de banda para Nest câmeras .

Limites de taxa aplicar-se a esta chamada, dependendo Ciente Nest status da assinatura .

detalhes
`https://developer-api.nest.com/devices/cameras/ device_id /snapshot_url`
Devoluções	`string` Exemplo: " `string1 / device_id / string2 ?auth= camera_token` " Cuidado: `string1` e `string2` são usados para fazer a chamada de API. Não altere string ou a chamada falhará.
Acesso	somente leitura
Disponível em	Camera leia + images / v3-v4 Câmera de leitura / gravação + images / v3-v4

Último evento

Este objeto captura informações sobre o último evento que desencadeou uma notificação.

Alguns campos e algumas combinações de permissão exigir um Ciente Nest assinatura para acessar informações último evento.

Toda a seguir os valores são encontrado em cada devices/cameras/ device_id /last_event no documento JSON.

has_sound

Som de evento - som foi detectado.

detalhes
`https://developer-api.nest.com/devices/cameras/ device_id /last_event/has_sound`
Devoluções	`boolean` Valores: verdadeiro, falso
Acesso	somente leitura
Disponível em	Câmera de leitura / v1-v3 Camera leia + images / v1-v4 Câmera de leitura / gravação / v1-v3 Câmera de leitura / gravação + images / v1-v4

has_motion

evento de movimento - o movimento foi detectado.

detalhes
`https://developer-api.nest.com/devices/cameras/ device_id /last_event/has_motion`
Devoluções	`boolean` Valores: verdadeiro, falso
Acesso	somente leitura
Disponível em	Câmera de leitura / v1-v3 Camera leia + images / v1-v4 Câmera de leitura / gravação / v1-v3 Câmera de leitura / gravação + images / v1-v4

has_person

Pessoa evento - uma pessoa foi detectado.

detalhes
`https://developer-api.nest.com/devices/cameras/ device_id /last_event/has_person`
Devoluções	`boolean` Valores: verdadeiro, falso
Acesso	somente leitura
Disponível em	Câmera de leitura / v1-v3 Camera leia + images / v1-v4 Câmera de leitura / gravação / v1-v3 Câmera de leitura / gravação + images / v1-v4

start_time

Evento hora de início, na ISO 8601 formato.

detalhes
`https://developer-api.nest.com/devices/cameras/ device_id /last_event/start_time`
Devoluções	`string` Exemplo: "2016-12-29T00: 00: 00.000Z"
Acesso	somente leitura
Disponível em	Câmera de leitura / v1-v3 Camera leia + images / v1-v4 Câmera de leitura / gravação / v1-v3 Câmera de leitura / gravação + images / v1-v4

Fim do tempo

Tempo do fim evento, na ISO 8601 formato.

detalhes
`https://developer-api.nest.com/devices/cameras/ device_id /last_event/end_time`
Devoluções	`string` Exemplo: "2016-12-29T00: 00: 00.000Z"
Acesso	somente leitura
Disponível em	Câmera de leitura / v1-v3 Camera leia + images / v1-v4 Câmera de leitura / gravação / v1-v3 Câmera de leitura / gravação + images / v1-v4

urls_expire_time

Timestamp, na ISO 8601 formato, que identifica o vencimento desses URLs relacionados ao evento:

last_event/web_url
last_event/app_url
last_event/image_url
last_event/animated_image_url

Tempo de expiração é calculada como: last_event/start_time + n dias (no qual n = 10 ou 30 dias, dependendo da Ciente ninho plano de assinatura ).

Requer Nest Aware .

detalhes
`https://developer-api.nest.com/devices/cameras/ device_id /last_event/urls_expire_time`
Devoluções	`string` Exemplo: "2016-12-29T00: 00: 00.000Z"
Acesso	somente leitura
Disponível em	Câmera de leitura / v1-v3 Camera leia + images / v1-v4 Câmera de leitura / gravação / v1-v3 Câmera de leitura / gravação + images / v1-v4

web_url

Web URL (link profundo) para o último som ou evento de movimento em home.nest.com . Usado para exibir o último evento registado, e exige do usuário a ser assinado na conta.

Requer Nest Aware . Se o URL do evento expirou ou o dispositivo não tem uma assinatura ativa, então este valor não está incluído na carga útil.

Veja last_event/urls_expire_time para obter informações sobre tempo de expiração deste URL.

detalhes
`https://developer-api.nest.com/devices/cameras/ device_id /last_event/web_url`
Devoluções	`string` Exemplo: " `https://home.nest.com/cameras/ device_id /cuepoints/ string ?auth= camera_token` "
Acesso	somente leitura
Disponível em	Câmera de leitura / v1-v3 Camera leia + images / v1-v4 Câmera de leitura / gravação / v1-v3 Câmera de leitura / gravação + images / v1-v4

APP_URL

URL ninho aplicativo (link de profundidade) para o último som ou evento de movimento. Usado para exibir o último evento registado, e exige do usuário a ser assinado na conta.

Requer Nest Aware . Se o URL do evento expirou ou o dispositivo não tem uma assinatura ativa, então este valor não está incluído na carga útil.

Veja last_event/urls_expire_time para obter informações sobre tempo de expiração deste URL.

detalhes
`https://developer-api.nest.com/devices/cameras/ device_id /last_event/app_url`
Devoluções	`string` Exemplo: " `nestmobile://cameras/ device_id /cuepoints/ string ?auth= camera_token` "
Acesso	somente leitura
Disponível em	Câmera de leitura / v1-v3 Camera leia + images / v1-v4 Câmera de leitura / gravação / v1-v3 Câmera de leitura / gravação + images / v1-v4

imagem URL

URL (link) para o arquivo de imagem capturada por um som ou movimento evento.

Requer Nest Aware . Veja last_event/urls_expire_time para obter informações sobre tempo de expiração deste URL.

detalhes
`https://developer-api.nest.com/devices/cameras/ device_id /last_event/image_url`
Devoluções	`string` Exemplo: " `https://www.dropcam.com/api/wwn.get_image/ string1 / device_id / string2 ?auth= camera_token` " Cuidado: `string1` e `string2` são usados para fazer a chamada de API. Não altere string ou a chamada falhará.
Acesso	somente leitura
Disponível em	Camera leia + images / v1-v4 Câmera de leitura / gravação + images / v1-v4

animated_image_url

URL (link) para o arquivo gif capturado por um som ou movimento evento.

Requer Nest Aware .

detalhes
`https://developer-api.nest.com/devices/cameras/ device_id /last_event/animated_image_url`
Devoluções	`string` Exemplo: " `https://www.dropcam.com/api/wwn.get_image/ string1 / device_id / string2 ?auth= camera_token` " Cuidado: `string1` e `string2` são usados para fazer a chamada de API. Não altere string ou a chamada falhará.
Acesso	somente leitura
Disponível em	Camera leia + images / v1-v4 Câmera de leitura / gravação + images / v1-v4

activity_zone_ids

Identificadores para a atividade de zonas que detectaram um evento de movimento.

Requer Nest Aware . Quando usado com o activity_zones matriz, você pode obter o nome da zona de estes ids.

Se last_event/has_motion é

true = retorna a zona de ids actividade que detectado um evento de movimento
false = retorna uma matriz vazia

detalhes
`https://developer-api.nest.com/devices/cameras/ device_id /last_event/activity_zone_ids`
Devoluções	`array` Exemplo: `[ string1 , string2 ,... ]`
Acesso	somente leitura
Disponível em	Camera leia + images / v3-v4 Câmera de leitura / gravação + images / v3-v4