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 | |
error | Bloqueado |
type | https://developers.nest.com/reference/error-messages#blocked |
message | Bloqueado |
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 | |
error | Não é possível ativar o ventilador durante a desativação da segurança |
type | https://developers.nest.com/reference/error-messages#safety-shutoff-on |
message | Nã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 | |
error | Não é possível mudar o estado "Ausente" com o aquecimento de emergência ativado |
type | https://developers.nest.com/reference/error-messages#emergency-heat-is-on |
message | Nã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 | |
error | Não é possível mudar 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 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
oueco
- O modo HVAC está definido como
eco
, e o produto tenta configurartarget_temperature
Parâmetros | |
---|---|
Código de status HTTP:400 Bad Request | |
error | Não é possível alterar o modo HVAC para $mode . O HVAC (aquecimento, ventilação e ar-condicionado) não pode $action |
type | https://developers.nest.com/reference/error-messages#incompatible-mode |
message | Não é possível alterar o modo HVAC para $mode . O HVAC (aquecimento, ventilação e ar-condicionado) não pode $action |
details | $mode |
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 | |
error | Não é possível mudar o modo HVAC (aquecimento, ventilação e ar-condicionado) enquanto o bloqueio do termostato está ativado |
type | https://developers.nest.com/reference/error-messages#lock-enabled |
message | Nã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 | |
error | Não é possível definir as temperaturas de C e F simultaneamente |
type | https://developers.nest.com/reference/error-messages#multiple-value-changes |
message | Nã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 | |
error | Não é possível ativar/desativar o fan_timer_active devido ao modo incompatível $mode |
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 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 | |
error | Não é possível definir fan_timer_duration para o valor selecionado. Consulte os valores permitidos na referência da API. |
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 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 | |
error | Não é possível definir a temperatura mínima desejada como $lowTemp mais alta do que a alta temperatura-alvo $highTemp |
type | https://developers.nest.com/reference/error-messages#low-high-error |
message | Não é possível definir a temperatura mínima desejada como $lowTemp mais alta do que a alta temperatura-alvo $highTemp |
details | $lowTemp |
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 | |
error | Não é possível definir a temperatura-alvo mais próxima de 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 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 | |
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 |
É 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 | |
error | Você 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. |
type | https://developers.nest.com/reference/error-messages#unsupported-firmware-version |
message | Você 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 | |
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 |
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 | |
error | O HEC está no passado: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime |
type | https://developers.nest.com/reference/error-messages#eta-in-the-past |
message | O HEC está no passado: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime |
details | $estimatedArrivalTime |
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 | |
error | O HEC está muito longe no futuro |
type | https://developers.nest.com/reference/error-messages#eta-too-far-in-the-future |
message | O 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 | |
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 Forbidden | |
error | Proibido |
type | https://developers.nest.com/reference/error-messages#forbidden |
message | Proibido |
Erro interno
Parâmetros | |
---|---|
Código de status HTTP: 500 Internal Server Error | |
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 Bad Request | |
error | ID da 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 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 | |
error | Conteúdo inválido enviado |
type | https://developers.nest.com/reference/error-messages#invalid-content-sent |
message | Conteú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 | |
error | Caminho do fragmento inválido: $requestPath |
type | https://developers.nest.com/reference/error-messages#invalid-fragment |
message | Caminho 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 | |
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 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 | |
error | ID do alarme de fumaça e CO inválido $id |
type | https://developers.nest.com/reference/error-messages#invalid-smoke-co-alarm-id |
message | ID 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 | |
error | O ID da estrutura $id é inválido |
type | https://developers.nest.com/reference/error-messages#invalid-structure-id |
message | Có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 | |
error | ID do termostato inválido: $id |
type | https://developers.nest.com/reference/error-messages#invalid-thermostat-id |
message | ID 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 | |
error | Valor inválido para "Ausente" |
type | https://developers.nest.com/reference/error-messages#invalid-away-value |
message | Valor 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 | |
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 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 | |
error | O marcador precisa ter menos de $max_label_length caracteres |
type | https://developers.nest.com/reference/error-messages#max-label-length |
message | O 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 | |
error | Máximo personalizado em que a contagem de $max_where_count excedeu |
type | https://developers.nest.com/reference/error-messages#max-where-count |
message | Má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 | |
error | O máximo personalizado de onde o comprimento do nome de $max_custom_where_name_length foi excedido |
type | https://developers.nest.com/reference/error-messages#max-where-name-length |
message | O 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 | |
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 Bad Request | |
error | ID do local ausente |
type | https://developers.nest.com/reference/error-messages#where-id-missing |
message | ID 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 | |
error | Sem ventilador de climatização |
type | https://developers.nest.com/reference/error-messages#no-hvac-fan |
message | Sem 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 | |
error | Nenhum termostato on-line |
type | https://developers.nest.com/reference/error-messages#no-thermostats-online |
message | Nenhum 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 | |
error | Nenhum dispositivo pareado |
type | https://developers.nest.com/reference/error-messages#no-paired-devices |
message | Nenhum 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 | |
error | Não há HEC válido para cancelar |
type | https://developers.nest.com/reference/error-messages#no-valid-eta-to-cancel |
message | Nã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 | |
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 é inválido. Por exemplo, uma chamada POST foi feita quando um PUT é necessário.
Parâmetros | |
---|---|
Código de status HTTP:400 Bad Request | |
error | Não é um tipo de solicitação válido: $requestType |
type | https://developers.nest.com/reference/error-messages#request-type-not-allowed |
message | Não é um tipo de solicitação válido: $requestType |
details | $requestType |
Não encontrado
A chamada tentou ler um caminho que não existe.
Parâmetros | |
---|---|
Código de status HTTP: 404 não encontrado | |
error | Não encontrado |
type | https://developers.nest.com/reference/error-messages#not-found |
message | Não encontrado |
Fora do modo "Ausente"
A estrutura não está no modo "Ausente" quando uma chamada 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 | |
error | Fora do modo "Ausente" |
type | https://developers.nest.com/reference/error-messages#not-in-away-mode |
message | Fora do modo "Ausente" |
Não gravável
O campo em que você está tentando gravar é somente leitura.
Parâmetros | |
---|---|
Código de status HTTP: 400 Bad Request | |
error | Não gravável |
type | https://developers.nest.com/reference/error-messages#not-writable |
message | Não gravável |
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 | |
error | Apenas onde o nome precisa ser fornecido |
type | https://developers.nest.com/reference/error-messages#extra-fields |
message | Apenas 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 | |
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 do esquema
Ocorreu um erro ao parear os dispositivos.
Parâmetros | |
---|---|
Código de status HTTP: 400 Bad Request | |
error | Violação do esquema |
type | https://developers.nest.com/reference/error-messages#schema-violation-error |
message | Violação do esquema |
Serviço indisponível
Parâmetros | |
---|---|
Código de status HTTP: 503 Service Unavailable | |
error | Serviço não disponível |
type | https://developers.nest.com/reference/error-messages#service-unavailable |
message | Serviç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 | |
error | A estrutura já tem o número máximo de dispositivos pareados permitidos |
type | https://developers.nest.com/reference/error-messages#max-number-devices-error |
message | A 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 | |
error | A estrutura não pertence ao usuário. |
type | https://developers.nest.com/reference/error-messages#structure-ownership-error-uri |
message | A 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 | |
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 |
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 | |
error | A 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 | A temperatura C $tempC é muito baixa para a temperatura de bloqueio $lowLockTemp |
details | $tempC |
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 | |
error | O valor de temperatura C é muito alto: $tempC |
type | https://developers.nest.com/reference/error-messages#high-c-value |
message | O 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 | |
error | O valor de temperatura C é muito baixo: $tempC |
type | https://developers.nest.com/reference/error-messages#low-c-value |
message | O 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 | |
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 |
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 | |
error | A temperatura F $tempF é muito baixa para a temperatura de bloqueio $lowLockTemp |
type | https://developers.nest.com/reference/error-messages#low-f-value-4-lock |
message | A temperatura F $tempF é muito baixa para a temperatura de bloqueio $lowLockTemp |
details | $tempF |
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 | |
error | O valor de temperatura F é muito alto: $tempF |
type | https://developers.nest.com/reference/error-messages#high-f-value |
message | O 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 | |
error | O valor de temperatura F é muito baixo: $tempF |
type | https://developers.nest.com/reference/error-messages#low-f-value |
message | O 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 | |
error | A temperatura $temp está no formato errado |
type | https://developers.nest.com/reference/error-messages#format-error |
message | A 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 | |
error | Não é possível modificar os campos na atualização: $fieldNames |
type | https://developers.nest.com/reference/error-messages#read-only-field-error |
message | Nã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 | |
error | Os campos precisam usar o formato ISO 8601: $fieldNames |
type | https://developers.nest.com/reference/error-messages#time-format-error |
message | Os 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 | |
error | O termostato não está on-line |
type | https://developers.nest.com/reference/error-messages#not-online |
message | O 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 | |
error | Esta viagem foi modificada manualmente |
type | https://developers.nest.com/reference/error-messages#trip-manually-overidden |
message | Esta 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 | |
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 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 | |
error | Não autorizadas |
type | https://developers.nest.com/reference/error-messages#auth-error |
message | Não autorizadas |
Desconhecido
Parâmetros | |
---|---|
Código de status HTTP: 400 Bad Request | |
error | desconhecido |
type | https://developers.nest.com/reference/error-messages#unknown |
message | desconhecido |
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 | |
error | Tipo de dispositivo/fornecedor desconhecido |
type | https://developers.nest.com/reference/error-messages#unknown-vendor-device-type-error |
message | Tipo 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 | |
error | O valor de $fieldName é do tipo incorreto. |
type | https://developers.nest.com/reference/error-messages#wrong-data-type |
message | O 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 | |
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
não está na chamada.
Parâmetros | |
---|---|
Código de status HTTP:400 Bad Request | |
error | Onde o nome não é fornecido |
type | https://developers.nest.com/reference/error-messages#where-name-missing |
message | Onde o nome não é fornecido |
Onde o nome tem comprimento zero
O name
não é definido (tem zero caracteres).
Parâmetros | |
---|---|
Código de status HTTP:400 Bad Request | |
error | Onde o nome tem comprimento zero |
type | https://developers.nest.com/reference/error-messages#zero-length-where-name |
message | Onde o nome tem comprimento zero |
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 | |
error | Em que o nome precisa ser uma string |
type | https://developers.nest.com/reference/error-messages#where-name-wrong-format |
message | Em 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 | |
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 |
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 | |
error | Onde "id" deve ser uma string |
type | https://developers.nest.com/reference/error-messages#where-id-wrong-format |
message | Onde "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.