O Google está comprometido em promover a equidade racial para as comunidades negras. Veja como.
Esta página foi traduzida pela API Cloud Translation.
Switch to English

Mensagens de erro

As condições de erro fazem parte do ciclo de desenvolvimento e podem variar de falhas simples, como um parâmetro ausente ou inválido, a cenários mais complexos, como um estado inesperado ou 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 aparece no objeto de details .
instance Uma sequência de texto que contém um identificador de erro exclusivo para cada chamada individual. Podemos solicitar o número da instância se você reportar 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 do Nest, consulte Outros códigos e mensagens de erro .

Bloqueado

O limite da taxa foi excedido.

Parâmetros
Código de status HTTP: 429 solicitações demais
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 contra 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 Solicitação incorreta
error Não é possível ativar o ventilador durante o desligamento de segurança contra 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 contra fumaça / co

Não é possível alterar o estado ausente enquanto o calor de emergência está ligado

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

Parâmetros
Código de status HTTP: 400 Solicitação incorreta
error Não é possível alterar o estado ausente enquanto o calor de emergência está ligado
type https://developers.nest.com/reference/error-messages#emergency-heat-is-on
message Não é possível alterar o estado ausente enquanto o calor de emergência está 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 da Nest está em vigor. As chamadas de API são rejeitadas até o término do evento de economia de energia.

Parâmetros
Código de status HTTP: 400 Solicitação incorreta
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 , 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 Solicitação incorreta
error Não é possível alterar o modo HVAC para o $mode ; O 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 ; O 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 Solicitação incorreta
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 Solicitação incorreta
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 o fan_timer_active devido ao modo incompatível

O ventilador do sistema HVAC já está engatado (manualmente pelo usuário, de acordo com a programação ou devido a um ciclo de aquecimento / resfriamento HVAC).

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

Parâmetros
Código de status HTTP: 400 Solicitação incorreta
error Não é possível ativar / desativar o 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 o 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 com um valor inválido. Consulte fan_timer_duration para obter uma lista de valores válidos.

Parâmetros
Código de status HTTP: 400 Solicitação incorreta
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 baixa alvo mais alta que a temperatura alta alvo

O termostato está no modo de heat-cool e o produto tentou definir uma temperatura alvo 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 Solicitação incorreta
error Não é possível definir a temperatura baixa alvo $lowTemp maior que a 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 maior que a temperatura alta alvo $highTemp
details $lowTemp
$highTemp

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

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

Parâmetros
Código de status HTTP: 400 Solicitação incorreta
error Não é possível definir a temperatura alvo mais próxima 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 que a $scale de $min graus $scale
details $min
$scale

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

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

Por exemplo, você não pode definir target_temperature_f ou target_temperature_c quando o sistema HVAC estiver off ou no modo de 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 de destino e o $mode pode ser qualquer um de: eco , emer_heat_enable , heat-cool , heat cool , off , hvac_safety_shutoff_active .

Parâmetros
Código de status HTTP: 400 Solicitação incorreta
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

Atualização de firmware do dispositivo necessária antes que você possa 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 Solicitação incorreta
error É necessária a atualização do firmware do dispositivo antes que você possa alterar o modo HVAC. As atualizações são automáticas, normalmente dentro de 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 que você possa alterar o modo HVAC. As atualizações são automáticas, normalmente dentro de uma semana após o lançamento.

Erro ao validar campos WWN

Parâmetros
Código de status HTTP: 400 Solicitação incorreta
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

O horário da ETA especificado está no passado (antes de NOW). Para obter mais informações sobre como fazer chamadas ETA, consulte o Guia ausente e ETA .

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

ETA está muito longe no futuro

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

Parâmetros
Código de status HTTP: 400 Solicitação incorreta
error A ETA está muito longe no futuro
type https://developers.nest.com/reference/error-messages#eta-too-far-in-the-future
message A 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 Solicitação incorreta
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: erro interno do servidor 500
error Erro interno
type https://developers.nest.com/reference/error-messages#internal-error
message Erro interno

ID de câmera inválido

O camera-id é inválido.

Parâmetros
Código de status HTTP: 400 Solicitação incorreta
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 "yes" em vez de "true" para uma variável booleana.

Parâmetros
Código de status HTTP: 400 Solicitação incorreta
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 da solicitação é inválida. Por exemplo, um nome de objeto ou campo pode estar incorreto.

Parâmetros
Código de status HTTP: 400 Solicitação incorreta
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 de climatização do termostato não suporta o modo solicitado pelo produto: heat , cool ou heat-cool .

Parâmetros
Código de status HTTP: 400 Solicitação incorreta
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 de alarme de fumaça + co inválido

O smoke_co_alarm_id é inválido.

Parâmetros
Código de status HTTP: 400 Solicitação incorreta
error Fumaça inválida + id do alarme co $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álido

O structure_id é inválido.

Parâmetros
Código de status HTTP: 400 Solicitação incorreta
error ID de estrutura inválido $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 Solicitação incorreta
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 Solicitação incorreta
error Valor inválido para ausente
type https://developers.nest.com/reference/error-messages#invalid-away-value
message Valor inválido: $value . Somente '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 Solicitação incorreta
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 Solicitação incorreta
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

Personalizado máximo onde a contagem excedeu

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

Parâmetros
Código de status HTTP: 400 Solicitação incorreta
error $max_where_count máximo, onde a contagem de $max_where_count excedida
type https://developers.nest.com/reference/error-messages#max-where-count
message $max_where_count máximo, onde 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 Solicitação incorreta
error $max_custom_where_name_length máximo, onde o comprimento do nome de $max_custom_where_name_length excedeu
type https://developers.nest.com/reference/error-messages#max-where-name-length
message $max_custom_where_name_length máximo, onde o comprimento do nome de $max_custom_where_name_length excedeu
details $max_custom_where_name_length

Campo ausente

Está faltando um parâmetro obrigatório na chamada.

Parâmetros
Código de status HTTP: 400 Solicitação incorreta
error Campo ausente: $fieldName
type https://developers.nest.com/reference/error-messages#field-is-missing
message Campo ausente: $fieldName
details $fieldName

ID do local ausente

O formato where_id está ausente.

Parâmetros
Código de status HTTP: 400 Solicitação incorreta
error ID de local ausente
type https://developers.nest.com/reference/error-messages#where-id-missing
message ID de local ausente

Nenhum ventilador HVAC

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

Parâmetros
Código de status HTTP: 400 Solicitação incorreta
error Nenhum ventilador de climatização
type https://developers.nest.com/reference/error-messages#no-hvac-fan
message Nenhum ventilador de climatização

Sem termostatos online

O termostato está atualmente offline. Depois que o wi-fi estiver ativado, seu produto deverá recuperar o acesso.

Parâmetros
Código de status HTTP: 400 Solicitação incorreta
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 estão emparelhados com a conta Nest do usuário .

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

Não há 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 Solicitação incorreta
error Não há ETA válido para cancelar
type https://developers.nest.com/reference/error-messages#no-valid-eta-to-cancel
message Não há ETA válido para cancelar

Sem permissão (s) de gravação para o (s) 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 Solicitação incorreta
error Nenhuma permissão de gravação para os campos: $fields
type https://developers.nest.com/reference/error-messages#no-write-permission
message Nenhuma 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 não é válido. Por exemplo, uma chamada POST foi feita quando uma PUT é necessária.

Parâmetros
Código de status HTTP: 400 Solicitação incorreta
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

Não está no modo ausente

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

Parâmetros
Código de status HTTP: 400 Solicitação incorreta
error Não está no modo ausente
type https://developers.nest.com/reference/error-messages#not-in-away-mode
message Não está no modo ausente

Não gravável

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

Parâmetros
Código de status HTTP: 400 Solicitação incorreta
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 no wheres chamada.

Parâmetros
Código de status HTTP: 400 Solicitação incorreta
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 solicitação válido

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

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

Violação de esquema

Ocorreu um erro ao emparelhar dispositivos.

Parâmetros
Código de status HTTP: 400 Solicitação incorreta
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 permitido de dispositivos emparelhados

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

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

A estrutura não pertence ao usuário

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

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

A temperatura C está muito alta para a temperatura de bloqueio

O termostato foi bloqueado pelo usuário e o produto tentou definir uma temperatura alvo em Celsius acima da faixa de temperatura de bloqueio.

Parâmetros
Código de status HTTP: 400 Solicitação incorreta
error A temperatura C $tempC é muito alta para a temperatura de bloqueio $highLockTemp
type https://developers.nest.com/reference/error-messages#high-c-value-4-lock
message A temperatura C $tempC é muito alta para a temperatura de bloqueio $highLockTemp
details $tempC
$highLockTemp

A temperatura C está muito baixa para a temperatura de bloqueio

O termostato foi bloqueado pelo usuário e o produto tentou definir uma temperatura alvo em Celsius abaixo da faixa de temperatura de bloqueio.

Parâmetros
Código de status HTTP: 400 Solicitação incorreta
error Temperatura C $tempC é muito baixa para a temperatura de bloqueio $lowLockTemp
type https://developers.nest.com/reference/error-messages#low-c-value-4-lock
message 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 de temperatura alvo muito alto para uma temperatura Celsius. Para faixas de temperatura permitidas em Celsius, consulte target_temperature_c .

Parâmetros
Código de status HTTP: 400 Solicitação incorreta
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 muito baixo para uma temperatura Celsius. Para faixas de temperatura permitidas em Celsius, consulte target_temperature_c .

Parâmetros
Código de status HTTP: 400 Solicitação incorreta
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 está muito alta para a temperatura de bloqueio

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

Parâmetros
Código de status HTTP: 400 Solicitação incorreta
error A temperatura F $tempF é muito alta para a temperatura de bloqueio $highLockTemp
type https://developers.nest.com/reference/error-messages#high-f-value-4-lock
message A 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 alvo em Fahrenheit abaixo da faixa de temperatura de bloqueio.

Parâmetros
Código de status HTTP: 400 Solicitação incorreta
error A temperatura F $tempF está muito baixa para a temperatura de bloqueio $lowLockTemp
type https://developers.nest.com/reference/error-messages#low-f-value-4-lock
message A temperatura F $tempF está muito baixa para a temperatura de bloqueio $lowLockTemp
details $tempF
$lowLockTemp

O valor da temperatura F é muito alto

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

Parâmetros
Código de status HTTP: 400 Solicitação incorreta
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 da temperatura F está muito baixo

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

Parâmetros
Código de status HTTP: 400 Solicitação incorreta
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 incorreto para a escala de temperature_scale escolhida. As temperaturas Celsius devem ser inteiras em incrementos de 0,5 grau (21,5), e as temperaturas em Fahrenheit devem ser inteiras inteiras (72).

Parâmetros
Código de status HTTP: 400 Solicitação incorreta
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

Os campos 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 Solicitação incorreta
error Os campos não podem ser modificados na atualização: $fieldNames
type https://developers.nest.com/reference/error-messages#read-only-field-error
message Os campos 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 Solicitação incorreta
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á atualmente offline. Depois que o wi-fi estiver ativado, seu produto deverá recuperar o acesso.

Parâmetros
Código de status HTTP: 400 Solicitação incorreta
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 substituiu a viagem manualmente.

Parâmetros
Código de status HTTP: 400 Solicitação incorreta
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

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

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

Parâmetros
Código de status HTTP: 400 Solicitação incorreta
error Não foi possível criar o ID do local
type https://developers.nest.com/reference/error-messages#wheres-missing
message Não foi possível criar o ID do local

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 HTTP não encaminha automaticamente o cabeçalho de autorização para o URI redirecionado. Para mais informações, consulte Como lidar com redirecionamentos .

  • permissões incorretas ao tentar acessar os pontos de extremidade da API. Por exemplo, tentando ler um ponto de extremidade do termostato quando apenas as permissões da câmera sã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
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 Solicitação incorreta
error desconhecido
type https://developers.nest.com/reference/error-messages#unknown
message desconhecido

Tipo de fornecedor / dispositivo desconhecido

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

Parâmetros
Código de status HTTP: 400 Solicitação incorreta
error Tipo de fornecedor / dispositivo desconhecido
type https://developers.nest.com/reference/error-messages#unknown-vendor-device-type-error
message Tipo de fornecedor / dispositivo desconhecido

O valor de $ fieldName é do tipo errado

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

Parâmetros
Código de status HTTP: 400 Solicitação incorreta
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 configurar já existe. Tente novamente com um novo nome.

Parâmetros
Código de status HTTP: 400 Solicitação incorreta
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á ausente na chamada.

Parâmetros
Código de status HTTP: 400 Solicitação incorreta
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

O name where não está definido (possui zero caracteres).

Parâmetros
Código de status HTTP: 400 Solicitação incorreta
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 nome deve ser uma sequência

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

Parâmetros
Código de status HTTP: 400 Solicitação incorreta
error Onde nome deve ser uma sequência
type https://developers.nest.com/reference/error-messages#where-name-wrong-format
message Onde nome deve ser uma sequência

where_id não existe

O where_id é inválido.

Parâmetros
Código de status HTTP: 400 Solicitação incorreta
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 sequência.

Parâmetros
Código de status HTTP: 400 Solicitação incorreta
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 do dispositivo

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

Códigos de erro REST

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

Mensagens de limite de taxa REST

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

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