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. | |
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 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 | |
error | Não é possível ativar o ventilador durante a desativação da segurança do dispositivo |
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 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 | |
error | Não é possível mudar o estado "Ausente" enquanto o aquecimento de emergência está ativado |
type | https://developers.nest.com/reference/error-messages#emergency-heat-is-on |
message | Nã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 | |
error | Não é possível mudar o modo HVAC (Aquecimento, ventilação e ar-condicionado) 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 (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
oueco
. - O modo HVAC está definido como
eco
, e o produto tenta definirtarget_temperature
Parâmetros | |
---|---|
Código de status HTTP:400 Bad Request | |
error | Não é possível mudar o modo HVAC para $mode . O sistema HVAC não pode $action |
type | https://developers.nest.com/reference/error-messages#incompatible-mode |
message | Não é possível mudar o modo HVAC para $mode . O sistema HVAC 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 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 | |
error | Não é possível definir as temperaturas C e F simultaneamente |
type | https://developers.nest.com/reference/error-messages#multiple-value-changes |
message | Nã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 | |
error | Não é possível ativar/desativar 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 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 | |
error | Não é possível definir fan_timer_duration como 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 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 | |
error | Não é possível definir a temperatura mínima desejada $lowTemp mais alta do que a $highTemp desejada |
type | https://developers.nest.com/reference/error-messages#low-high-error |
message | Não é possível definir a temperatura mínima desejada $lowTemp mais alta do que a $highTemp desejada |
details | $lowTemp |
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 | |
error | Não é possível definir a temperatura desejada em mais de N graus C/F |
type | https://developers.nest.com/reference/error-messages#range-error |
message | Nã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 | |
error | Não é possível definir target_temperature enquanto o modo está em $mode |
type | https://developers.nest.com/reference/error-messages#mode-error |
message | Não é possível definir $fieldName enquanto o modo está no $mode |
details | $fieldName |
É 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. |
type | https://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 | |
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 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 | |
error | O tempo estimado de chegada está no passado: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime |
type | https://developers.nest.com/reference/error-messages#eta-in-the-past |
message | O tempo estimado de chegada está no passado: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime |
details | $estimatedArrivalTime |
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 | |
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
fan_timer_active
não está definido.
Parâmetros | |
---|---|
Código de status HTTP:400 Bad Request | |
error | fan_timer_active não definido |
type | https://developers.nest.com/reference/error-messages#fan-timer-active-value-missing |
message | fan_timer_active não definido |
Proibido
As credenciais usadas para acessar o serviço Nest são inválidas.
Parâmetros | |
---|---|
Código de status HTTP:403 Proibido | |
error | Proibido |
type | https://developers.nest.com/reference/error-messages#forbidden |
message | Proibido |
Erro interno
Parâmetros | |
---|---|
Código de status HTTP:Erro interno do servidor 500 | |
error | Erro interno |
type | https://developers.nest.com/reference/error-messages#internal-error |
message | Erro interno |
ID da 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 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 | |
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 Bad Request | |
error | Caminho de fragmento inválido: $requestPath |
type | https://developers.nest.com/reference/error-messages#invalid-fragment |
message | Caminho de fragmento inválido: $requestPath |
details | $requestPath |
Modo HVAC (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 | |
error | Modo HVAC (aquecimento, ventilação e ar-condicionado) inválido: $mode |
type | https://developers.nest.com/reference/error-messages#invalid-mode |
message | Modo 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 | |
error | ID do alarme de fumaça + CO inválido $id |
type | https://developers.nest.com/reference/error-messages#invalid-smoke-co-alarm-id |
message | ID 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 | |
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 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 "Ausente" inválido
Você tentou definir um valor inválido para away
.
Parâmetros | |
---|---|
Código de status HTTP:400 Bad Request | |
error | Valor "Ausente" inválido |
type | https://developers.nest.com/reference/error-messages#invalid-away-value |
message | Valor 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 | |
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 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 rótulo precisa ter menos de $max_label_length caracteres |
type | https://developers.nest.com/reference/error-messages#max-label-length |
message | O 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 | |
error | O máximo de personalização onde a contagem de $max_where_count foi excedida |
type | https://developers.nest.com/reference/error-messages#max-where-count |
message | O 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 | |
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.
A chamada não tem um parâmetro obrigatório.
Parâmetros | |
---|---|
Código de status HTTP:400 Bad Request | |
error | Campo ausente: $fieldName |
type | https://developers.nest.com/reference/error-messages#field-is-missing |
message | Campo ausente: $fieldName |
details | $fieldName |
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 (aquecimento, ventilação e ar-condicionado) não parece ter um ventilador independente.
Parâmetros | |
---|---|
Código de status HTTP:400 Bad Request | |
error | Sem ventilador de HVAC |
type | https://developers.nest.com/reference/error-messages#no-hvac-fan |
message | Sem 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 | |
error | Não tem termostatos on-line |
type | https://developers.nest.com/reference/error-messages#no-thermostats-online |
message | Nã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 | |
error | Nenhum dispositivo pareado |
type | https://developers.nest.com/reference/error-messages#no-paired-devices |
message | Nenhum 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 | |
error | Nenhum ETA válido para cancelar |
type | https://developers.nest.com/reference/error-messages#no-valid-eta-to-cancel |
message | Nenhum ETA válido para cancelar |
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 | |
error | Nenhuma permissão de gravação para o(s) campo(s): $fields |
type | https://developers.nest.com/reference/error-messages#no-write-permission |
message | Nenhuma 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 | |
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 de ETA são aceitas somente 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 o nome precisa ser informado
Campos extras foram incluídos na chamada
wheres
.
Parâmetros | |
---|---|
Código de status HTTP:400 Bad Request | |
error | Apenas o nome precisa ser informado |
type | https://developers.nest.com/reference/error-messages#extra-fields |
message | Apenas 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 | |
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 Serviço indisponível | |
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 é 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 | |
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 desejada de Celsius acima da 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 desejada de 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 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 | |
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 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 | |
error | O valor da temperatura C é muito baixo: $tempC |
type | https://developers.nest.com/reference/error-messages#low-c-value |
message | O valor da temperatura C é muito baixo: $tempC |
details | $tempC |
A temperatura F é muito alta para a temperatura de bloqueio
O termostato foi bloqueado pelo usuário, e o produto tentou definir uma temperatura desejada de 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 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 | |
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 |
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 | |
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 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 | |
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 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 | |
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 | 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 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, o produto precisará recuperar o 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 substituída manualmente
O usuário substituiu manualmente a viagem.
Parâmetros | |
---|---|
Código de status HTTP:400 Bad Request | |
error | Esta viagem foi substituída manualmente |
type | https://developers.nest.com/reference/error-messages#trip-manually-overridden |
message | Esta 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 | |
error | Não é possível criar o ID do local |
type | https://developers.nest.com/reference/error-messages#wheres-missing |
message | Nã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) | |
error | Não autorizado |
type | https://developers.nest.com/reference/error-messages#auth-error |
message | Não autorizado |
Desconhecida
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 incorreto foi enviado. Por exemplo, o envio de uma string quando um booleano é esperado.
Parâmetros | |
---|---|
Código de status HTTP:400 Bad Request | |
error | O valor de $fieldName é do tipo errado |
type | https://developers.nest.com/reference/error-messages#wrong-data-type |
message | O valor de $fieldName é do tipo errado |
details | $fieldName |
Onde o nome já existe
O where_name
que o produto tentou definir já existe. Tente novamente com um novo
nome.
Parâmetros | |
---|---|
Código de status HTTP:400 Bad Request | |
error | Onde o nome $name já existe |
type | https://developers.nest.com/reference/error-messages#where-name-exists |
message | Onde o nome $name já existe |
details | $name |
Onde o nome não é fornecido
O where_name
está ausente 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
Em que name
não está definido (tem zero caracteres).
Parâmetros | |
---|---|
Código de status HTTP:400 Bad Request | |
error | Onde o nome tem comprimento zero |
type | https://developers.nest.com/reference/error-messages#zero-length-where-name |
message | Onde o nome tem comprimento zero |
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 | |
error | O nome precisa ser uma string |
type | https://developers.nest.com/reference/error-messages#where-name-wrong-format |
message | 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 |
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 | |
error | em que where_id precisa ser uma string |
type | https://developers.nest.com/reference/error-messages#where-id-wrong-format |
message | em 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.