Notice: We're retiring Works with Nest. See the home page for more information.
O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.
Esta página foi traduzida pela API Cloud Translation.
Switch to English

Mensagens de erro

Condições de erro fazem parte do ciclo de desenvolvimento e podem variar de falhas simples, como um parâmetro inválido ou ausente, a cenários mais complexos, como um estado inesperado ou até mesmo configurações relacionadas ao dispositivo, que devem ser resolvidas fora da API.

Quando ocorre um erro durante uma chamada de API, uma resposta neste formato é enviada:

{
  "error": "Temperature '$temp' is in wrong format",
  "type": "https://developers.nest.com/documentation/cloud/error-messages#format-error",
  "message": "Temperature '$temp' is in wrong format",
  "instance": "31441a94-ed26-11e4-90ec-1681e6b88ec1",
  "details": {
    "field_name": "$temp"
  }
}

Todas as mensagens de erro contêm os campos de error , type , message e instance . O objeto de details é opcional.

Campo Descrição
error Formato de mensagem de erro curta.
type Fornece um URL para informações detalhadas sobre a condição de erro (esta página).
message Formato de mensagem de erro longo que pode usar variáveis ​​para fornecer detalhes adicionais. Quando uma variável é incluída na mensagem, ela aparecerá no objeto de details .
instance Uma string de texto que contém um identificador de erro exclusivo para cada chamada individual. Podemos pedir o número da instância se você relatar um problema com o serviço.
details Opcional. Contém variáveis ​​que são inseridas na message . As mensagens podem conter várias variáveis.

Para obter informações sobre erros não relacionados à API Nest, consulte Outros códigos e mensagens de erro .

Bloqueado

O limite da taxa foi excedido.

parâmetros
Código de status HTTP: 429 Muitas solicitações
error Bloqueado
type https://developers.nest.com/reference/error-messages#blocked
message Bloqueado

Não é possível ativar o ventilador durante o desligamento de segurança de fumaça / co

O desligamento de emergência está em vigor. As chamadas de API não são aceitas até que a operação normal seja restaurada.

Parâmetros
Código de status HTTP: 400 Bad Request
error Não é possível ativar o ventilador durante o desligamento de segurança de fumaça / co
type https://developers.nest.com/reference/error-messages#safety-shutoff-on
message Não é possível ativar o ventilador durante o desligamento de segurança de fumaça / co

Não é possível alterar o estado ausente enquanto o aquecimento de emergência estiver ligado

O produto tentou alterar o estado Ausente enquanto o Calor de emergência estava ligado.

Parâmetros
Código de status HTTP: 400 Bad Request
error Não é possível alterar o estado ausente enquanto o aquecimento de emergência estiver ligado
type https://developers.nest.com/reference/error-messages#emergency-heat-is-on
message Não é possível alterar o estado ausente enquanto o aquecimento de emergência estiver ligado

Não é possível alterar o modo HVAC durante eventos de economia de energia

Um evento de economia de energia definido por um parceiro de energia Nest está em vigor. As chamadas de API são rejeitadas até que o evento de economia de energia termine.

Parâmetros
Código de status HTTP: 400 Bad Request
error Não é possível alterar o modo HVAC durante eventos de economia de energia
type https://developers.nest.com/reference/error-messages#energy-saving-event-on
message Não é possível alterar o modo HVAC durante eventos de economia de energia

Não é possível alterar o modo HVAC

O modo é incompatível com a solicitação.

Por exemplo, você pode receber esta mensagem se:

  • O sistema HVAC do termostato não suporta o modo solicitado pelo seu produto: heat , cool , cool heat-cool ou eco
  • O modo HVAC é definido como eco e o produto tenta definir a target_temperature
Parâmetros
Código de status HTTP: 400 Bad Request
error Não é possível alterar o modo HVAC para o $mode ; HVAC não pode $action
type https://developers.nest.com/reference/error-messages#incompatible-mode
message Não é possível alterar o modo HVAC para o $mode ; HVAC não pode $action
details $mode
$action

Não é possível alterar o modo HVAC enquanto o bloqueio do termostato está ativado

O usuário deve desbloquear o termostato antes que um produto possa gravar dados.

Parâmetros
Código de status HTTP: 400 Bad Request
error Não é possível alterar o modo HVAC enquanto o bloqueio do termostato está ativado
type https://developers.nest.com/reference/error-messages#lock-enabled
message Não é possível alterar o modo HVAC enquanto o bloqueio do termostato está ativado

Não é possível definir temperaturas C e F simultaneamente

O produto tentou definir as temperaturas-alvo Celsius e Fahrenheit ao mesmo tempo. Um produto deve definir apenas a temperatura alvo especificada pela temperature_scale (C / F).

Parâmetros
Código de status HTTP: 400 Bad Request
error Não é possível definir temperaturas C e F simultaneamente
type https://developers.nest.com/reference/error-messages#multiple-value-changes
message Não é possível definir temperaturas C e F simultaneamente

Não é possível ativar / desativar fan_timer_active devido a modo incompatível

O ventilador do sistema HVAC já está ativado (manualmente pelo usuário, ou em uma programação, ou por causa de um ciclo de aquecimento / resfriamento HVAC).

Se você não obtiver o resultado esperado, é mais provável que o dispositivo tenha um comportamento integrado que não podemos substituir por meio da API.

Parâmetros
Código de status HTTP: 400 Bad Request
error Não é possível ativar / desativar fan_timer_active devido ao modo $mode incompatível
type https://developers.nest.com/reference/error-messages#incompatible-fan-mode
message Não é possível ativar / desativar fan_timer_active devido ao modo $mode incompatível
details $mode

Não é possível definir fan_timer_duration para o valor selecionado

O produto tentou definir fan_timer_duration para um valor inválido. Veja fan_timer_duration para uma lista de valores válidos.

Parâmetros
Código de status HTTP: 400 Bad Request
error Não é possível definir fan_timer_duration para o valor selecionado. Consulte a referência da API para obter os valores permitidos.
type https://developers.nest.com/reference/error-messages#invalid-fan-timer-duration
message Não é possível definir fan_timer_duration para o valor selecionado. Consulte a referência da API para obter os valores permitidos.

Não é possível definir a temperatura mínima desejada mais alta do que a temperatura alta desejada

O termostato está no modo de heat-cool e o produto tentou definir uma temperatura desejada baixa / alta que está fora da faixa. Por exemplo, o produto tentou definir target_temperature_low_c para 25 ° C quando target_temperature_high_c é 24 ° C.

Parâmetros
Código de status HTTP: 400 Bad Request
error Não é possível definir a temperatura baixa alvo $lowTemp superior à temperatura alta alvo $highTemp
type https://developers.nest.com/reference/error-messages#low-high-error
message Não é possível definir a temperatura baixa alvo $lowTemp superior à temperatura alta alvo $highTemp
details $lowTemp
$highTemp

Não é possível definir a temperatura alvo mais próxima do que N graus C / F

O produto tentou definir um valor de temperatura alvo muito próximo da temperatura alta / baixa alvo (por exemplo, target_temperature_high_f ).

Parâmetros
Código de status HTTP: 400 Bad Request
error Não é possível definir a temperatura alvo mais próxima do que N graus C / F
type https://developers.nest.com/reference/error-messages#range-error
message Não é possível definir a temperatura alvo mais próxima do que $min graus $scale
details $min
$scale

Não é possível definir target_temperature enquanto o modo é $ mode

O termostato ou estrutura está atualmente em um modo que não oferece suporte a solicitações de API.

Por exemplo, você não pode definir target_temperature_f ou target_temperature_c quando o sistema HVAC está off ou no modo heat-cool . O valor não pode ser alterado até que o termostato / estrutura volte para um modo não restrito.

Nesta mensagem, $fieldName pode ser qualquer um dos valores de temperatura alvo e $mode pode ser qualquer um destes: eco , emer_heat_enable , heat-cool , heat , cool , off , hvac_safety_shutoff_active .

Parâmetros
Código de status HTTP: 400 Bad Request
error Não é possível definir target_temperature enquanto o modo é $mode
type https://developers.nest.com/reference/error-messages#mode-error
message Não é possível definir $fieldName enquanto o modo é $mode
details $fieldName
$mode

É necessária a atualização do firmware do dispositivo antes de alterar o modo HVAC

O dispositivo deve ser atualizado para a versão atual do firmware para definir as temperaturas ecológicas.

Parâmetros
Código de status HTTP: 400 Bad Request
error É necessária a atualização do firmware do dispositivo antes de alterar o modo HVAC. As atualizações são automáticas, normalmente uma semana após o lançamento.
type https://developers.nest.com/reference/error-messages#unsupported-firmware-version
message É necessária a atualização do firmware do dispositivo antes de alterar o modo HVAC. As atualizações são automáticas, normalmente uma semana após o lançamento.

Erro ao validar campos WWN

Parâmetros
Código de status HTTP: 400 Bad Request
error Erro ao validar campos WWN: $error
type https://developers.nest.com/reference/error-messages#where-id-internal
message Erro ao validar campos WWN: $error
details $error

ETA está no passado

A hora ETA especificada está no passado (antes de AGORA). Para obter mais informações sobre como fazer chamadas ETA, consulte o Guia de Ausência e ETA .

Parâmetros
Código de status HTTP: 400 Bad Request
error ETA está no passado: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime
type https://developers.nest.com/reference/error-messages#eta-in-the-past
message ETA está no passado: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime
details $estimatedArrivalTime
$currentTime

ETA está muito longe no futuro

O horário de ETA especificado não pode ser mais de 8 horas no futuro. Para obter mais informações sobre como fazer chamadas ETA, consulte o Guia de Ausência e ETA .

Parâmetros
Código de status HTTP: 400 Bad Request
error O HEC está muito longe no futuro
type https://developers.nest.com/reference/error-messages#eta-too-far-in-the-future
message O ETA está muito longe no futuro

fan_timer_active não definido

fan_timer_active não está definido.

Parâmetros
Código de status HTTP: 400 Bad Request
error fan_timer_active não definido
type https://developers.nest.com/reference/error-messages#fan-timer-active-value-missing
message fan_timer_active não definido

Proibido

As credenciais usadas para acessar o serviço Nest são inválidas.

Parâmetros
Código de status HTTP: 403 proibido
error Proibido
type https://developers.nest.com/reference/error-messages#forbidden
message Proibido

Erro interno

Parâmetros
Código de status HTTP: 500 Erro interno do servidor
error Erro interno
type https://developers.nest.com/reference/error-messages#internal-error
message Erro interno

ID de câmera inválido

A camera-id é inválida.

Parâmetros
Código de status HTTP: 400 Bad Request
error ID de câmera inválido $id
type https://developers.nest.com/reference/error-messages#invalid-camera-id
message ID de câmera inválido: $id
details $id

Conteúdo inválido enviado

A chamada contém conteúdo inválido. Por exemplo, usando "sim" em vez de "verdadeiro" para uma variável booleana.

Parâmetros
Código de status HTTP: 400 Bad Request
error Conteúdo inválido enviado
type https://developers.nest.com/reference/error-messages#invalid-content-sent
message Conteúdo inválido enviado

Caminho de fragmento inválido

Parte do caminho do pedido é inválido. Por exemplo, um objeto ou nome de campo pode estar incorreto.

Parâmetros
Código de status HTTP: 400 Bad Request
error Caminho de fragmento inválido: $requestPath
type https://developers.nest.com/reference/error-messages#invalid-fragment
message Caminho de fragmento inválido: $requestPath
details $requestPath

Modo HVAC inválido

O sistema HVAC do termostato não oferece suporte ao modo solicitado pelo produto: heat , cool ou heat-cool .

Parâmetros
Código de status HTTP: 400 Bad Request
error Modo HVAC inválido: $mode
type https://developers.nest.com/reference/error-messages#invalid-mode
message Modo HVAC inválido: $mode
details $mode

ID inválido de alarme de fumaça + co

O smoke_co_alarm_id é inválido.

parâmetros
Código de status HTTP: 400 Bad Request
error ID de alarme de fumaça + co inválido $id
type https://developers.nest.com/reference/error-messages#invalid-smoke-co-alarm-id
message ID de alarme de fumaça + co inválido: $id
details $id

ID de estrutura inválida

O structure_id é inválido.

Parâmetros
Código de status HTTP: 400 Bad Request
error Estrutura inválida id $id
type https://developers.nest.com/reference/error-messages#invalid-structure-id
message Id de estrutura inválido: $id
details $id

ID de termostato inválido

O thermostat_id é inválido.

Parâmetros
Código de status HTTP: 400 Bad Request
error Id de termostato inválido $id
type https://developers.nest.com/reference/error-messages#invalid-thermostat-id
message Id de termostato inválido: $id
details $id

Valor inválido para Ausente

Você tentou definir um valor inválido para away .

Parâmetros
Código de status HTTP: 400 Bad Request
error Valor inválido para Ausente
type https://developers.nest.com/reference/error-messages#invalid-away-value
message Valor inválido: $value . Apenas 'casa' e 'fora' são valores permitidos.
details $value

is_streaming não é booleano

O produto tentou definir o campo is-streaming como não booleano.

Parâmetros
Código de status HTTP: 400 Bad Request
error is_streaming não é booleano
type https://developers.nest.com/reference/error-messages#invalid-is-stream-format
message is_streaming não é booleano

O rótulo deve ter menos de 256 caracteres

O produto tentou criar um rótulo de termostato com mais de 256 caracteres.

Parâmetros
Código de status HTTP: 400 Bad Request
error O rótulo deve ter menos de $max_label_length caracteres
type https://developers.nest.com/reference/error-messages#max-label-length
message O rótulo deve ter menos de $max_label_length caracteres
details $max_label_length

Personalização máxima onde a contagem foi excedida

O produto tentou criar um objeto personalizado onde wheres além do máximo. O número máximo de costume wheres objetos permitido é 32.

Parâmetros
Código de status HTTP: 400 Bad Request
error $max_where_count máxima em que a contagem de $max_where_count excedida
type https://developers.nest.com/reference/error-messages#max-where-count
message $max_where_count máxima em que a contagem de $max_where_count excedida
details $max_where_count

Personalizado máximo onde o comprimento do nome excedeu

O name where é muito longo. Recomendamos menos de 30 caracteres.

Parâmetros
Código de status HTTP: 400 Bad Request
error $max_custom_where_name_length máximo onde o comprimento do nome de $max_custom_where_name_length excedido
type https://developers.nest.com/reference/error-messages#max-where-name-length
message $max_custom_where_name_length máximo em que o comprimento do nome de $max_custom_where_name_length excedido
details $max_custom_where_name_length

Campo ausente

A chamada está sem um parâmetro obrigatório.

parâmetros
Código de status HTTP: 400 Bad Request
error Campo ausente: $fieldName
type https://developers.nest.com/reference/error-messages#field-is-missing
message Campo ausente: $fieldName
details $fieldName

Falta onde ID

O formato where_id está faltando.

Parâmetros
Código de status HTTP: 400 Bad Request
error Faltando Onde Id
type https://developers.nest.com/reference/error-messages#where-id-missing
message Faltando Onde Id

Sem ventilador HVAC

O sistema HVAC não parece ter um ventilador independente.

Parâmetros
Código de status HTTP: 400 Bad Request
error Sem ventilador de avac
type https://developers.nest.com/reference/error-messages#no-hvac-fan
message Sem ventilador de AVAC

Sem termostatos online

O termostato está offline no momento. Depois que o wi-fi estiver ativado, seu produto deve recuperar o acesso.

Parâmetros
Código de status HTTP: 400 Bad Request
error Sem termostatos online
type https://developers.nest.com/reference/error-messages#no-thermostats-online
message Sem termostatos online

Nenhum dispositivo emparelhado

Os dispositivos Nest do usuário não são pareados com a conta Nest do usuário .

Parâmetros
Código de status HTTP: 400 Bad Request
error Nenhum dispositivo emparelhado
type https://developers.nest.com/reference/error-messages#no-paired-devices
message Nenhum dispositivo emparelhado

Nenhum ETA válido para cancelar

A viagem não é válida e não pode ser cancelada.

parâmetros
Código de status HTTP: 400 Bad Request
error Nenhum ETA válido para cancelar
type https://developers.nest.com/reference/error-messages#no-valid-eta-to-cancel
message Nenhum ETA válido para cancelar

Sem permissão (s) de gravação para campo (s)

O cliente não tem permissão de gravação para esses dados. Para obter mais informações, consulte a Visão geral de permissões .

Parâmetros
Código de status HTTP: 400 Bad Request
error Sem permissão (s) de gravação para o (s) campo (s): $fields
type https://developers.nest.com/reference/error-messages#no-write-permission
message Sem permissão (s) de gravação para o (s) campo (s): $fields
details $fields

Não é um tipo de pedido válido

O tipo de solicitação não é válido. Por exemplo, uma chamada POST foi feita quando um PUT é necessário.

Parâmetros
Código de status HTTP: 400 Bad Request
error Não é um tipo de solicitação válido: $requestType
type https://developers.nest.com/reference/error-messages#request-type-not-allowed
message Não é um tipo de solicitação válido: $requestType
details $requestType

Não encontrado

A chamada tentou ler um caminho que não existe.

Parâmetros
Código de status HTTP: 404 não encontrado
error Não encontrado
type https://developers.nest.com/reference/error-messages#not-found
message Não encontrado

Fora do modo Ausente

A estrutura não está no modo Ausente quando uma chamada ETA é feita. As chamadas ETA só são aceitas quando a estrutura está definida como Ausente.

Parâmetros
Código de status HTTP: 400 Bad Request
error Fora do modo Ausente
type https://developers.nest.com/reference/error-messages#not-in-away-mode
message Fora do modo Ausente

Não gravável

O campo no qual você está tentando gravar é somente leitura.

Parâmetros
Código de status HTTP: 400 Bad Request
error Não gravável
type https://developers.nest.com/reference/error-messages#not-writable
message Não gravável

Somente onde o nome precisa ser fornecido

Campos extras foram incluídos na chamada wheres .

Parâmetros
Código de status HTTP: 400 Bad Request
error Somente onde o nome precisa ser fornecido
type https://developers.nest.com/reference/error-messages#extra-fields
message Somente onde o nome precisa ser fornecido

POST não é um tipo de pedido válido

O tipo de solicitação é inválido. Por exemplo, uma chamada POST foi feita quando um PUT é necessário.

Parâmetros
Código de status HTTP: 400 Bad Request
error POST não é um tipo de pedido válido
type https://developers.nest.com/reference/error-messages#invalid-request-type
message POST não é um tipo de pedido válido

Violação de esquema

Ocorreu um erro ao emparelhar dispositivos.

Parâmetros
Código de status HTTP: 400 Bad Request
error Violação de esquema
type https://developers.nest.com/reference/error-messages#schema-violation-error
message Violação de esquema

Serviço indisponível

Parâmetros
Código de status HTTP: 503 Serviço indisponível
error Serviço indisponível
type https://developers.nest.com/reference/error-messages#service-unavailable
message Serviço indisponível

A estrutura já possui o número máximo de dispositivos emparelhados permitidos

A estrutura já possui o número máximo de dispositivos permitidos .

Parâmetros
Código de status HTTP: 400 Bad Request
error A estrutura já possui o número máximo de dispositivos emparelhados permitidos
type https://developers.nest.com/reference/error-messages#max-number-devices-error
message A estrutura já possui o número máximo de dispositivos emparelhados permitidos

A estrutura não é propriedade do usuário

O structure_id não corresponde à conta do usuário de registro.

Parâmetros
Código de status HTTP: 400 Bad Request
error A estrutura não é propriedade do usuário.
type https://developers.nest.com/reference/error-messages#structure-ownership-error-uri
message A estrutura não é propriedade do usuário.

A temperatura C é muito alta para a temperatura de bloqueio

O termostato foi bloqueado pelo usuário e o produto tentou definir uma temperatura desejada em Celsius maior do que a faixa de temperatura de bloqueio.

Parâmetros
Código de status HTTP: 400 Bad Request
error Temperatura C $tempC é muito alta para temperatura de bloqueio $highLockTemp
type https://developers.nest.com/reference/error-messages#high-c-value-4-lock
message Temperatura C $tempC é muito alta para temperatura de bloqueio $highLockTemp
details $tempC
$highLockTemp

Temperatura C é muito baixa para temperatura de bloqueio

O termostato foi bloqueado pelo usuário e o produto tentou definir uma temperatura desejada em Celsius inferior à faixa de temperatura de bloqueio.

Parâmetros
Código de status HTTP: 400 Bad Request
error Temperatura C $tempC é muito baixa para temperatura de bloqueio $lowLockTemp
type https://developers.nest.com/reference/error-messages#low-c-value-4-lock
message Temperatura C $tempC é muito baixa para temperatura de bloqueio $lowLockTemp
details $tempC
$lowLockTemp

O valor da temperatura C é muito alto

O produto tentou definir um valor de temperatura alvo que é muito alto para uma temperatura Celsius. Para as faixas de temperatura permitidas em Celsius, consulte target_temperature_c .

Parâmetros
Código de status HTTP: 400 Bad Request
error O valor da temperatura C é muito alto: $tempC
type https://developers.nest.com/reference/error-messages#high-c-value
message O valor da temperatura C é muito alto: $tempC
details $tempC

O valor da temperatura C é muito baixo

O produto tentou definir um valor de temperatura alvo que é muito baixo para uma temperatura Celsius. Para as faixas de temperatura permitidas em Celsius, consulte target_temperature_c .

Parâmetros
Código de status HTTP: 400 Bad Request
error O valor da temperatura C é muito baixo: $tempC
type https://developers.nest.com/reference/error-messages#low-c-value
message O valor da temperatura C é muito baixo: $tempC
details $tempC

A temperatura F é muito alta para a temperatura de bloqueio

O termostato foi bloqueado pelo usuário e o produto tentou definir uma temperatura desejada em Fahrenheit superior à faixa de temperatura de bloqueio.

Parâmetros
Código de status HTTP: 400 Bad Request
error Temperatura F $tempF é muito alta para temperatura de bloqueio $highLockTemp
type https://developers.nest.com/reference/error-messages#high-f-value-4-lock
message Temperatura F $tempF é muito alta para temperatura de bloqueio $highLockTemp
details $tempF
$highLockTemp

Temperatura F é muito baixa para temperatura de bloqueio

O termostato foi bloqueado pelo usuário e o produto tentou definir uma temperatura desejada em Fahrenheit inferior à faixa de temperatura de bloqueio.

Parâmetros
Código de status HTTP: 400 Bad Request
error A temperatura F $tempF é muito baixa para a temperatura de bloqueio $lowLockTemp
type https://developers.nest.com/reference/error-messages#low-f-value-4-lock
message Temperatura F $tempF é muito baixa para temperatura de bloqueio $lowLockTemp
details $tempF
$lowLockTemp

O valor F da temperatura é muito alto

O produto tentou definir um valor de temperatura alvo que é muito alto para uma temperatura Fahrenheit. Para faixas de temperatura permitidas em Fahrenheit, consulte target_temperature_f .

Parâmetros
Código de status HTTP: 400 Bad Request
error O valor da temperatura F é muito alto: $tempF
type https://developers.nest.com/reference/error-messages#high-f-value
message O valor da temperatura F é muito alto: $tempF
details $tempF

O valor F da temperatura é muito baixo

O produto tentou definir um valor de temperatura alvo que é muito baixo para uma temperatura Fahrenheit. Para faixas de temperatura permitidas em Fahrenheit, consulte target_temperature_f .

Parâmetros
Código de status HTTP: 400 Bad Request
error O valor da temperatura F é muito baixo: $tempF
type https://developers.nest.com/reference/error-messages#low-f-value
message O valor da temperatura F é muito baixo: $tempF
details $tempF

A temperatura está no formato errado

O produto tentou definir uma temperatura alvo usando o formato de número errado para a temperature_scale escolhida. As temperaturas Celsius devem ser inteiros em incrementos de 0,5 graus (21,5), e as temperaturas Fahrenheit devem ser inteiros inteiros (72).

Parâmetros
Código de status HTTP: 400 Bad Request
error Temperatura $temp está no formato errado
type https://developers.nest.com/reference/error-messages#format-error
message Temperatura $temp está no formato errado
details $temp

O (s) campo (s) não podem ser modificados na atualização

O produto tentou gravar em um campo somente leitura.

Parâmetros
Código de status HTTP: 400 Bad Request
error O (s) campo (s) não podem ser modificados na atualização: $fieldNames
type https://developers.nest.com/reference/error-messages#read-only-field-error
message O (s) campo (s) não podem ser modificados na atualização: $fieldNames
details $fieldNames

Os campos devem usar o formato ISO 8601

O campo não está no formato ISO 8601 .

Parâmetros
Código de status HTTP: 400 Bad Request
error Os campos devem usar o formato ISO 8601: $fieldNames
type https://developers.nest.com/reference/error-messages#time-format-error
message Os campos devem usar o formato ISO 8601: $fieldNames
details $fieldNames

O termostato não está online

O termostato está offline no momento. Depois que o wi-fi estiver ativado, seu produto deve recuperar o acesso.

Parâmetros
Código de status HTTP: 400 Bad Request
error O termostato não está online
type https://developers.nest.com/reference/error-messages#not-online
message O termostato não está online

Esta viagem foi substituída manualmente

O usuário cancelou manualmente a viagem.

Parâmetros
Código de status HTTP: 400 Bad Request
error Esta viagem foi substituída manualmente
type https://developers.nest.com/reference/error-messages#trip-manually-overidden
message Esta viagem foi substituída manualmente

Incapaz de criar onde ID

O wheres objeto está faltando. Nenhum valor where_id é definido.

Parâmetros
Código de status HTTP: 400 Bad Request
error Incapaz de criar onde id
type https://developers.nest.com/reference/error-messages#wheres-missing
message Incapaz de criar onde id

Não autorizado

A autorização falhou.

Algumas condições podem gerar esta mensagem de erro:

  • redirecionamentos incorretos que ocorrem quando uma determinada implementação de HTTP não encaminha automaticamente o cabeçalho Authorization para o URI redirecionado. Para obter mais informações, consulte Como lidar com redirecionamentos .

  • permissões incorretas ao tentar acessar pontos de extremidade da API. Por exemplo, tentar ler um ponto de extremidade do termostato quando apenas as permissões de câmera são selecionadas para o cliente. Para obter mais informações, consulte Como escolher permissões .

Parâmetros
Código de status HTTP: 401 não autorizado
error Não autorizado
type https://developers.nest.com/reference/error-messages#auth-error
message Não autorizado

Desconhecido

Parâmetros
Código de status HTTP: 400 Bad Request
error desconhecido
type https://developers.nest.com/reference/error-messages#unknown
message desconhecido

Fornecedor / tipo de dispositivo desconhecido

Fornecedor / dispositivo não reconhecido durante o emparelhamento do dispositivo.

Parâmetros
Código de status HTTP: 400 Bad Request
error Fornecedor / tipo de dispositivo desconhecido
type https://developers.nest.com/reference/error-messages#unknown-vendor-device-type-error
message Fornecedor / tipo de dispositivo desconhecido

O valor de $ fieldName é do tipo errado

O tipo de dados incorreto foi enviado. Por exemplo, enviar uma string quando um booleano é esperado.

Parâmetros
Código de status HTTP: 400 Bad Request
error O valor de $fieldName é do tipo errado
type https://developers.nest.com/reference/error-messages#wrong-data-type
message O valor de $fieldName é do tipo errado
details $fieldName

Onde o nome já existe

O where_name o produto tentou definir já existe. Tente novamente com um novo nome.

Parâmetros
Código de status HTTP: 400 Bad Request
error Onde o nome $name já existe
type https://developers.nest.com/reference/error-messages#where-name-exists
message Onde o nome $name já existe
details $name

Onde o nome não é fornecido

O where_name está faltando na chamada.

Parâmetros
Código de status HTTP: 400 Bad Request
error Onde o nome não é fornecido
type https://developers.nest.com/reference/error-messages#where-name-missing
message Onde o nome não é fornecido

Onde o nome tem comprimento zero

Onde o name não está definido (tem zero caracteres).

Parâmetros
Código de status HTTP: 400 Bad Request
error Onde o nome tem comprimento zero
type https://developers.nest.com/reference/error-messages#zero-length-where-name
message Onde o nome tem comprimento zero

Onde o nome deve ser uma string

O tipo de dados incorreto foi enviado para where_name . Por exemplo, um número quando uma string é esperada.

Parâmetros
Código de status HTTP: 400 Bad Request
error Onde o nome deve ser uma string
type https://developers.nest.com/reference/error-messages#where-name-wrong-format
message Onde o nome deve ser uma string

where_id não existe

O where_id é inválido.

Parâmetros
Código de status HTTP: 400 Bad Request
error where_id não existe
type https://developers.nest.com/reference/error-messages#where-id-invalid
message where_id não existe
details $where_id

where_id deve ser uma string

O formato where_id é inválido. Por exemplo, um número foi enviado em vez de uma string.

Parâmetros
Código de status HTTP: 400 Bad Request
error where_id deve ser uma string
type https://developers.nest.com/reference/error-messages#where-id-wrong-format
message where_id deve ser uma string

Outros códigos e mensagens de erro

códigos de erro Device

Para códigos de erro específicos do dispositivo e mensagens não relacionadas à API Nest, consulte o seguinte:

Códigos de erro REST

Quando você faz uma chamada de API REST, códigos de status HTTP comuns são retornados.

Mensagens de limite de taxa REST

Ao usar o REST e enviar muitas chamadas em um curto período de tempo, você pode receber um código de status de resposta HTTP de 429 Too Many Requests.

Para obter mais informações, consulte Limites de taxa de dados .