Mensagens de erro

As condições de erro fazem parte do ciclo de desenvolvimento e podem variar desde 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 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 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 de erro (esta 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 pedir o número da instância se você informar um problema no serviço.
details Opcional. Contém variáveis que são inseridas no message. As mensagens podem conter diversas variáveis.

Para saber mais sobre erros não relacionados à API Nest, consulte Outros códigos e mensagens de erro.

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 do dispositivo

O desligamento de emergência está em vigor. As chamadas de API não serã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 do dispositivo
typehttps://developers.nest.com/reference/error-messages#safety-shutoff-on
messageNão é possível ativar o ventilador durante a desativação da segurança do dispositivo

Não é possível mudar o estado "Ausente" enquanto o aquecimento de emergência está 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" enquanto o aquecimento de emergência está ativado
typehttps://developers.nest.com/reference/error-messages#emergency-heat-is-on
messageNão é possível mudar o estado "Ausente" enquanto o aquecimento de emergência está ativado

Não é possível mudar o modo HVAC (Aquecimento, ventilação e ar-condicionado) durante eventos de economia de energia

Um evento de economia de energia definido por um parceiro de energia da Nest está em vigor. As chamadas de API serão rejeitadas 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 (Aquecimento, ventilação e ar-condicionado) 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 (Aquecimento, ventilação e ar-condicionado) 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ê poderá receber essa mensagem se:

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

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

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

Não é possível ativar/desativar 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 por causa de um ciclo de aquecimento/refrigeração).

Se você não receber o resultado esperado, é mais provável que o dispositivo tenha um comportamento integrado que não pode ser modificado pela API.

Parâmetros
Código de status HTTP:400 Bad Request
errorNão é possível ativar/desativar 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 fan_timer_active devido ao modo incompatível $mode
details$mode

Não é possível definir fan_timer_duration como 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 como 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 como o valor selecionado. Consulte os valores permitidos na referência da API.

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

O termostato está no modo heat-cool, e o produto tentou definir uma temperatura-alvo baixa/alta fora do intervalo. Por exemplo, o produto tentou definir target_temperature_low_c como 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 $lowTemp mais alta do que a $highTemp desejada
typehttps://developers.nest.com/reference/error-messages#low-high-error
messageNão é possível definir a temperatura mínima desejada $lowTemp mais alta do que a $highTemp desejada
details$lowTemp
$highTemp

Não é possível definir a temperatura desejada em mais de N graus C/F

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

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

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

No momento, o termostato ou a estrutura está em um modo que não aceita 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 pode ser alterado até que o termostato/a estrutura volte para o modo não restrito.

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

Parâmetros
Código de status HTTP:400 Bad Request
errorNão é possível definir target_temperature enquanto o modo está em $mode
typehttps://developers.nest.com/reference/error-messages#mode-error
messageNão é possível definir $fieldName enquanto o modo está no $mode
details$fieldName
$mode

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

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

Parâmetros
Código de status HTTP:400 Bad Request
errorÉ necessário atualizar o firmware do dispositivo antes de alterar o modo HVAC (Aquecimento, ventilação e ar-condicionado). As atualizações são automáticas, geralmente em até uma semana após o lançamento.
typehttps://developers.nest.com/reference/error-messages#unsupported-firmware-version
messageÉ necessário atualizar o firmware do dispositivo antes de alterar o modo HVAC (Aquecimento, ventilação e ar-condicionado). As atualizações são automáticas, geralmente em até 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 horário estimado de chegada é no passado (antes NOW). Para mais informações sobre como fazer chamadas de ETA, consulte o Guia "Ausente" e "ETA".

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

O tempo previsto de chegada é muito distante

O tempo de ETA especificado não pode ser superior a 8 horas no futuro. Para mais informações sobre chamadas de ETA, consulte o Guia "Ausente" e "ETA".

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

fan_timer_active não está definido.

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 Proibido
errorProibido
typehttps://developers.nest.com/reference/error-messages#forbidden
messageProibido

Erro interno

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

ID da 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 da câmera inválido: $id
details$id

Conteúdo inválido enviado

A chamada tem conteúdo inválido. Por exemplo, usar "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 de fragmento inválido

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

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

Modo HVAC (aquecimento, ventilação e ar-condicionado) 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 (aquecimento, ventilação e ar-condicionado) inválido: $mode
typehttps://developers.nest.com/reference/error-messages#invalid-mode
messageModo HVAC (aquecimento, ventilação e ar-condicionado) 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 + CO inválido $id
typehttps://developers.nest.com/reference/error-messages#invalid-smoke-co-alarm-id
messageID do alarme de fumaça/co inválido: $id
details$id

ID da estrutura inválido

O structure_id é inválido.

Parâmetros
Código de status HTTP:400 Bad Request
errorID de estrutura inválido $id
typehttps://developers.nest.com/reference/error-messages#invalid-structure-id
messageID 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 "Ausente" inválido

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

Parâmetros
Código de status HTTP:400 Bad Request
errorValor "Ausente" inválido
typehttps://developers.nest.com/reference/error-messages#invalid-away-value
messageValor inválido: $value. Somente "casa" e "fora de casa" 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 rótulo 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 rótulo precisa ter menos de $max_label_length caracteres
typehttps://developers.nest.com/reference/error-messages#max-label-length
messageO rótulo precisa ter menos de $max_label_length caracteres
details$max_label_length

Máximo personalizado onde 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
errorO máximo de personalização onde a contagem de $max_where_count foi excedida
typehttps://developers.nest.com/reference/error-messages#max-where-count
messageO máximo de personalização onde a contagem de $max_where_count foi excedida
details$max_where_count

Máximo personalizado onde 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.

A chamada não tem um parâmetro obrigatório.

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 (aquecimento, ventilação e ar-condicionado) não parece ter um ventilador independente.

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

Não tem termostatos on-line

O termostato está off-line no momento. Depois que o Wi-Fi estiver ativado, o produto precisará recuperar o acesso.

Parâmetros
Código de status HTTP:400 Bad Request
errorNão tem termostatos on-line
typehttps://developers.nest.com/reference/error-messages#no-thermostats-online
messageNão tem termostatos 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

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
errorNenhum ETA válido para cancelar
typehttps://developers.nest.com/reference/error-messages#no-valid-eta-to-cancel
messageNenhum ETA válido para cancelar

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

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

Parâmetros
Código de status HTTP:400 Bad Request
errorNenhuma permissão de gravação para o(s) campo(s): $fields
typehttps://developers.nest.com/reference/error-messages#no-write-permission
messageNenhuma permissão de gravação para o(s) campo(s): $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 de ETA são aceitas somente 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 o nome precisa ser informado

Campos extras foram incluídos na chamada wheres.

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

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 Serviço indisponível
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 é de propriedade do usuário

O structure_id não corresponde à conta do 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 desejada de Celsius acima da 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 desejada de 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 da temperatura C é muito alto

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

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

O valor da temperatura C é muito baixo

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

Parâmetros
Código de status HTTP:400 Bad Request
errorO valor da temperatura C é muito baixo: $tempC
typehttps://developers.nest.com/reference/error-messages#low-c-value
messageO 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 de 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 está muito baixa para a temperatura de bloqueio

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

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

O valor de temperatura F é muito alto

O produto tentou definir um valor desejado de temperatura muito alto para uma temperatura de Farheheit. Para ver 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 desejado de temperatura muito baixo para uma temperatura de Farheheit. Para ver 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 desejada usando o formato de número errado para a temperature_scale escolhida. As temperaturas Celsius devem ser números inteiros em incrementos de 0,5 grau (21,5), e as temperaturas 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
errorOs campos não podem ser modificados na atualização: $fieldNames
typehttps://developers.nest.com/reference/error-messages#read-only-field-error
messageOs campos não podem ser modificados 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, o produto precisará recuperar o 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 substituída manualmente

O usuário substituiu manualmente a viagem.

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

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

O objeto wheres está ausente. Nenhum valor de where_id foi definido.

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

Não autorizado

Falha na autorização.

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

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

  • permissões incorretas ao tentar acessar endpoints de API. Por exemplo, tendo a leitura de 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 autorizado
typehttps://developers.nest.com/reference/error-messages#auth-error
messageNão autorizado

Desconhecida

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 incorreto foi enviado. Por exemplo, o envio de uma string quando um booleano é esperado.

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

Onde o nome já existe

O where_name que o produto tentou definir 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 está ausente 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

Em que name não está 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

O nome precisa 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
errorO nome precisa ser uma string
typehttps://developers.nest.com/reference/error-messages#where-name-wrong-format
messageO 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

em que where_id precisa 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
errorem que where_id precisa ser uma string
typehttps://developers.nest.com/reference/error-messages#where-id-wrong-format
messageem que where_id precisa ser uma string

Outros códigos de erro e mensagens

Códigos de erro do dispositivo

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

Códigos de erro REST

Ao fazer uma chamada da API REST, são retornados códigos de status HTTP comuns.

Mensagens de limite de taxa REST

Ao usar REST e enviar muitas chamadas em um curto período, você pode receber um código de status da resposta HTTP de 429 Muitos pedidos.

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