O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.

Mensagens de erro

As condições de erro fazem parte do ciclo de desenvolvimento e podem variar de falhas simples, como um parâmetro inválido ou ausente, até cenários mais complexos, como um estado inesperado ou até mesmo configurações relacionadas ao dispositivo, que precisam ser resolvidos 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 error, type, message e instance. O objeto details é opcional.

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

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

Bloqueado

O limite de taxa foi excedido.

Parâmetros
Código de status HTTP: 429 solicitações em excesso
errorBloqueado
typehttps://developers.nest.com/reference/error-messages#blocked
messageBloqueado

Não é possível ativar o ventilador durante a desativação da segurança

A 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
errorNão é possível ativar o ventilador durante a desativação da segurança
typehttps://developers.nest.com/reference/error-messages#safety-shutoff-on
messageNão é possível ativar o ventilador durante a desativação da segurança

Não é possível mudar o estado "Ausente" com o aquecimento de emergência ativado

O produto tentou mudar o estado "Ausente" enquanto o aquecimento de emergência estava ativado.

Parâmetros
Código de status HTTP: 400 Bad Request
errorNão é possível mudar o estado "Ausente" com o aquecimento de emergência ativado
typehttps://developers.nest.com/reference/error-messages#emergency-heat-is-on
messageNão é possível mudar o estado "Ausente" com o aquecimento de emergência ativado

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

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

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

Não é possível mudar o modo HVAC (aquecimento, ventilação e ar-condicionado)

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

Por exemplo, você pode receber essa mensagem se:

  • O sistema HVAC (aquecimento, ventilação e ar-condicionado) do termostato não é compatível com o modo solicitado pelo seu produto: heat, cool, heat-cool ou eco
  • O modo HVAC está definido como eco, e o produto tenta configurar target_temperature
Parâmetros
Código de status HTTP:400 Bad Request
errorNão é possível alterar o modo HVAC para $mode. O HVAC (aquecimento, ventilação e ar-condicionado) não pode $action
typehttps://developers.nest.com/reference/error-messages#incompatible-mode
messageNão é possível alterar o modo HVAC para $mode. O HVAC (aquecimento, ventilação e ar-condicionado) não pode $action
details$mode
$action

Não é possível mudar o modo HVAC (aquecimento, ventilação e ar-condicionado) enquanto o bloqueio do termostato está ativado

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

Parâmetros
Código de status HTTP: 400 Bad Request
errorNão é possível mudar o modo HVAC (aquecimento, ventilação e ar-condicionado) enquanto o bloqueio do termostato está ativado
typehttps://developers.nest.com/reference/error-messages#lock-enabled
messageNão é possível mudar o modo HVAC (aquecimento, ventilação e ar-condicionado) enquanto o bloqueio do termostato está ativado

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

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

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

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

O ventilador do sistema HVAC (aquecimento, ventilação e ar-condicionado) já está conectado (manualmente pelo usuário, em uma programação ou devido a um ciclo de aquecimento/refrigeração do HVAC).

Se você não receber o resultado esperado, é provável que o dispositivo tenha um comportamento integrado que não podemos modificar pela API.

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

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

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

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

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

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

Parâmetros
Código de status HTTP: 400 Bad Request
errorNão é possível definir a temperatura mínima desejada como $lowTemp mais alta do que a alta temperatura-alvo $highTemp
typehttps://developers.nest.com/reference/error-messages#low-high-error
messageNão é possível definir a temperatura mínima desejada como $lowTemp mais alta do que a alta temperatura-alvo $highTemp
details$lowTemp
$highTemp

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

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

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

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

O termostato ou a estrutura estão em um modo que não é compatível com solicitações de API.

Por exemplo, não é possível definir target_temperature_f ou target_temperature_c quando o sistema HVAC é off ou no modo heat-cool. O valor não poderá ser alterado até que o termostato/a 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
errorNão é possível definir target_temperature enquanto o modo é $mode
typehttps://developers.nest.com/reference/error-messages#mode-error
messageNão é possível definir $fieldName enquanto o modo é $mode
details$fieldName
$mode

É preciso atualizar o firmware do dispositivo para mudar o modo HVAC (aquecimento, ventilação e ar-condicionado)

O dispositivo precisa estar atualizado para a versão atual do firmware para definir as Temperaturas econômicas.

Parâmetros
Código de status HTTP:400 Bad Request
errorVocê precisa atualizar o firmware do dispositivo para mudar o modo HVAC (aquecimento, ventilação e ar-condicionado). As atualizações são automáticas, geralmente uma semana após o lançamento.
typehttps://developers.nest.com/reference/error-messages#unsupported-firmware-version
messageVocê precisa atualizar o firmware do dispositivo para mudar o modo HVAC (aquecimento, ventilação e ar-condicionado). As atualizações são automáticas, geralmente uma semana após o lançamento.

Erro ao validar campos WWN

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

O HEC está no passado

O tempo especificado do HEC está no passado (antes de AGORA). Para mais informações sobre como fazer chamadas de ETA, consulte o Guia de HEC "fora de casa".

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

O HEC está muito longe no futuro

O tempo estimado de chegada não pode ser superior a oito horas no futuro. Para mais informações sobre como fazer chamadas de HEC, consulte o Guia de HEC "fora de casa".

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

fan_timer_active não definido

A variável fan_timer_active não está definida.

Parâmetros
Código de status HTTP: 400 Bad Request
errorfan_timer_active não definido
typehttps://developers.nest.com/reference/error-messages#fan-timer-active-value-missing
messagefan_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 Forbidden
errorProibido
typehttps://developers.nest.com/reference/error-messages#forbidden
messageProibido

Erro interno

Parâmetros
Código de status HTTP: 500 Internal Server Error
errorErro interno
typehttps://developers.nest.com/reference/error-messages#internal-error
messageErro interno

ID de câmera inválido

O camera-id é inválido.

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

Conteúdo inválido enviado

A chamada tem conteúdo inválido. Por exemplo, usando "yes" em vez de "true" para uma variável booleana.

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

Caminho do fragmento inválido

Parte do caminho da solicitação é inválida. Por exemplo, um nome de objeto ou de campo pode estar incorreto.

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

Modo HVAC inválido

O sistema HVAC (aquecimento, ventilação e ar-condicionado) do termostato não é compatível com o modo solicitado pelo produto: heat, cool ou heat-cool.

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

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

O smoke_co_alarm_id é inválido.

Parâmetros
Código de status HTTP: 400 Bad Request
errorID do alarme de fumaça e CO inválido $id
typehttps://developers.nest.com/reference/error-messages#invalid-smoke-co-alarm-id
messageID inválido de alarme de fumaça e cozinheiro: $id
details$id

ID de estrutura inválido

O structure_id é inválido.

Parâmetros
Código de status HTTP: 400 Bad Request
errorO ID da estrutura $id é inválido
typehttps://developers.nest.com/reference/error-messages#invalid-structure-id
messageCódigo de estrutura inválido: $id
details$id

ID do termostato inválido

O thermostat_id é inválido.

Parâmetros
Código de status HTTP:400 Bad Request
errorID do termostato inválido: $id
typehttps://developers.nest.com/reference/error-messages#invalid-thermostat-id
messageID do 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
errorValor inválido para "Ausente"
typehttps://developers.nest.com/reference/error-messages#invalid-away-value
messageValor inválido: $value. Apenas 'home' e 'long' 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
erroris_streaming não é booleano
typehttps://developers.nest.com/reference/error-messages#invalid-is-stream-format
messageis_streaming não é booleano

O marcador precisa ter menos de 256 caracteres

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

Parâmetros
Código de status HTTP: 400 Bad Request
errorO marcador precisa ter menos de $max_label_length caracteres
typehttps://developers.nest.com/reference/error-messages#max-label-length
messageO marcador precisa ter menos de $max_label_length caracteres
details$max_label_length

Máximo personalizado em que a contagem foi excedida

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

Parâmetros
Código de status HTTP:400 Bad Request
errorMáximo personalizado em que a contagem de $max_where_count excedeu
typehttps://developers.nest.com/reference/error-messages#max-where-count
messageMáximo personalizado em que a contagem de $max_where_count excedeu
details$max_where_count

Máximo personalizado em que o comprimento do nome foi excedido

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

Parâmetros
Código de status HTTP: 400 Bad Request
errorO máximo personalizado de onde o comprimento do nome de $max_custom_where_name_length foi excedido
typehttps://developers.nest.com/reference/error-messages#max-where-name-length
messageO máximo personalizado de onde o comprimento do nome de $max_custom_where_name_length foi excedido
details$max_custom_where_name_length

Campo ausente

Falta um parâmetro obrigatório na chamada.

Parâmetros
Código de status HTTP: 400 Bad Request
errorCampo ausente: $fieldName
typehttps://developers.nest.com/reference/error-messages#field-is-missing
messageCampo ausente: $fieldName
details$fieldName

ID do local ausente

O formato where_id está ausente.

Parâmetros
Código de status HTTP:400 Bad Request
errorID do local ausente
typehttps://developers.nest.com/reference/error-messages#where-id-missing
messageID do local ausente

Sem ventilador de HVAC

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

Parâmetros
Código de status HTTP:400 Bad Request
errorSem ventilador de climatização
typehttps://developers.nest.com/reference/error-messages#no-hvac-fan
messageSem ventilador de climatização

Nenhum termostato on-line

O termostato está off-line no momento. Depois que o Wi-Fi estiver ativado, seu produto voltará a ter acesso.

Parâmetros
Código de status HTTP: 400 Bad Request
errorNenhum termostato on-line
typehttps://developers.nest.com/reference/error-messages#no-thermostats-online
messageNenhum termostato on-line

Nenhum dispositivo pareado

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

Parâmetros
Código de status HTTP:400 Bad Request
errorNenhum dispositivo pareado
typehttps://developers.nest.com/reference/error-messages#no-paired-devices
messageNenhum dispositivo pareado

Não há HEC 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
errorNão há HEC válido para cancelar
typehttps://developers.nest.com/reference/error-messages#no-valid-eta-to-cancel
messageNão há HEC válido para cancelar

Nenhuma permissão de gravação para os campos

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

Parâmetros
Código de status HTTP: 400 Bad Request
errorNenhuma permissão de gravação para os campos: $fields
typehttps://developers.nest.com/reference/error-messages#no-write-permission
messageNenhuma permissão de gravação para os campos: $fields
details$fields

Não é um tipo de solicitação 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
errorNão é um tipo de solicitação válido: $requestType
typehttps://developers.nest.com/reference/error-messages#request-type-not-allowed
messageNã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
errorNão encontrado
typehttps://developers.nest.com/reference/error-messages#not-found
messageNão encontrado

Fora do modo "Ausente"

A estrutura não está no modo "Ausente" quando uma chamada de 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
errorFora do modo "Ausente"
typehttps://developers.nest.com/reference/error-messages#not-in-away-mode
messageFora do modo "Ausente"

Não gravável

O campo em que você está tentando gravar é somente leitura.

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

Apenas onde o nome precisa ser fornecido

Campos extras foram incluídos na chamada wheres.

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

POST não é um tipo de solicitação 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
errorPOST não é um tipo de solicitação válido.
typehttps://developers.nest.com/reference/error-messages#invalid-request-type
messagePOST não é um tipo de solicitação válido.

Violação do esquema

Ocorreu um erro ao parear os dispositivos.

Parâmetros
Código de status HTTP: 400 Bad Request
errorViolação do esquema
typehttps://developers.nest.com/reference/error-messages#schema-violation-error
messageViolação do esquema

Serviço indisponível

Parâmetros
Código de status HTTP: 503 Service Unavailable
errorServiço não disponível
typehttps://developers.nest.com/reference/error-messages#service-unavailable
messageServiço não disponível

A estrutura já tem o número máximo de dispositivos pareados permitidos

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

Parâmetros
Código de status HTTP: 400 Bad Request
errorA estrutura já tem o número máximo de dispositivos pareados permitidos
typehttps://developers.nest.com/reference/error-messages#max-number-devices-error
messageA estrutura já tem o número máximo de dispositivos pareados permitidos

A estrutura não pertence ao usuário

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

Parâmetros
Código de status HTTP: 400 Bad Request
errorA estrutura não pertence ao usuário.
typehttps://developers.nest.com/reference/error-messages#structure-ownership-error-uri
messageA estrutura não pertence ao 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-alvo Celsius maior que a faixa de temperatura de bloqueio.

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

A temperatura C é muito baixa para a temperatura de bloqueio

O termostato foi bloqueado pelo usuário, e o produto tentou definir uma temperatura-alvo Celsius menor que a faixa de temperatura de bloqueio.

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

O valor de temperatura C é muito alto

O produto tentou definir um valor de temperatura desejado muito alto para uma temperatura elsius. Para faixas de temperatura permitidas em Celsius, consulte target_temperature_c.

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

O valor da temperatura C é muito baixo

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

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

A temperatura F é muito alta para a temperatura de bloqueio

O usuário fechou o termostato, e o produto tentou definir uma temperatura-alvo Fahrenheit maior que a faixa de temperatura de bloqueio.

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

A temperatura F é muito baixa para a temperatura de bloqueio

O termostato foi bloqueado pelo usuário, e o produto tentou definir uma temperatura-alvo Fahrenheit menor que a faixa de temperatura de bloqueio.

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

O valor de temperatura F é muito alto

O produto tentou definir um valor de temperatura desejado muito alto para uma temperatura de Frarenheit. Para ver as faixas de temperatura permitidas em Fahrenheit, consulte target_temperature_f.

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

O valor de temperatura F é muito baixo

O produto tentou definir um valor de temperatura desejado muito baixo para uma temperatura de Frarenheit. Para ver as faixas de temperatura permitidas em Fahrenheit, consulte target_temperature_f.

Parâmetros
Código de status HTTP:400 Bad Request
errorO valor de temperatura F é muito baixo: $tempF
typehttps://developers.nest.com/reference/error-messages#low-f-value
messageO valor de 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 em Celsius devem ser números inteiros em incrementos de 0,5 grau (21,5), e as temperaturas em Fahrenheit devem ser números inteiros (72).

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

Não é possível modificar os campos na atualização.

O produto tentou gravar em um campo somente leitura.

Parâmetros
Código de status HTTP: 400 Bad Request
errorNão é possível modificar os campos na atualização: $fieldNames
typehttps://developers.nest.com/reference/error-messages#read-only-field-error
messageNão é possível modificar os campos na atualização: $fieldNames
details$fieldNames

Os campos precisam usar o formato ISO 8601

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

Parâmetros
Código de status HTTP:400 Bad Request
errorOs campos precisam usar o formato ISO 8601: $fieldNames
typehttps://developers.nest.com/reference/error-messages#time-format-error
messageOs campos precisam usar o formato ISO 8601: $fieldNames
details$fieldNames

O termostato não está on-line

O termostato está off-line no momento. Depois que o Wi-Fi estiver ativado, seu produto voltará a ter acesso.

Parâmetros
Código de status HTTP: 400 Bad Request
errorO termostato não está on-line
typehttps://developers.nest.com/reference/error-messages#not-online
messageO termostato não está on-line

Esta viagem foi modificada manualmente

O usuário substituiu manualmente a viagem.

Parâmetros
Código de status HTTP: 400 Bad Request
errorEsta viagem foi modificada manualmente
typehttps://developers.nest.com/reference/error-messages#trip-manually-overidden
messageEsta viagem foi modificada manualmente

Não foi possível criar o ID do local

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

Parâmetros
Código de status HTTP:400 Bad Request
errorNão foi possível criar o ID do local.
typehttps://developers.nest.com/reference/error-messages#wheres-missing
messageNão foi possível criar o ID do local.

Não autorizadas

Falha na autorização.

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

  • redirecionamentos incorretos que ocorrem quando uma determinada implementação HTTP não encaminha automaticamente o cabeçalho de autorização ao URI redirecionado. Para mais informações, consulte Como processar redirecionamentos.

  • permissões incorretas ao tentar acessar endpoints da API. Por exemplo, tentando ler um endpoint do termostato quando apenas as permissões da câmera estão selecionadas para o cliente. Para mais informações, consulte Como escolher permissões.

Parâmetros
Código de status HTTP:401 não autorizado
errorNão autorizadas
typehttps://developers.nest.com/reference/error-messages#auth-error
messageNão autorizadas

Desconhecido

Parâmetros
Código de status HTTP: 400 Bad Request
errordesconhecido
typehttps://developers.nest.com/reference/error-messages#unknown
messagedesconhecido

Tipo de dispositivo/fornecedor desconhecido

O fornecedor/dispositivo não foi reconhecido durante o pareamento.

Parâmetros
Código de status HTTP: 400 Bad Request
errorTipo de dispositivo/fornecedor desconhecido
typehttps://developers.nest.com/reference/error-messages#unknown-vendor-device-type-error
messageTipo de dispositivo/fornecedor desconhecido

O valor de $fieldName é do tipo incorreto

O tipo de dados enviado está incorreto. Por exemplo, enviar uma string quando um booleano for esperado.

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

Onde o nome já existe

A where_name que o produto tentou configurar já existe. Tente novamente com um novo nome.

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

Onde o nome não é fornecido

O where_name não está na chamada.

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

Onde o nome tem comprimento zero

O name não é definido (tem zero caracteres).

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

Em que o nome precisa ser uma string

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

Parâmetros
Código de status HTTP:400 Bad Request
errorEm que o nome precisa ser uma string
typehttps://developers.nest.com/reference/error-messages#where-name-wrong-format
messageEm que o nome precisa ser uma string

where_id não existe

O where_id é inválido.

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

Onde "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
errorOnde "id" deve ser uma string
typehttps://developers.nest.com/reference/error-messages#where-id-wrong-format
messageOnde "id" deve ser uma string

Outros códigos de erro e mensagens

Códigos de erro do dispositivo

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 à API REST, os 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, você poderá receber um código de status da resposta HTTP 429 Too Many Applications (Solicitações em excesso).

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