Las condiciones de error son parte del ciclo de desarrollo y pueden variar desde fallas simples, como un parámetro no válido o faltante, hasta escenarios más complejos, como un estado inesperado o incluso configuraciones relacionadas con el dispositivo, que deben resolverse fuera de la API.
Cuando ocurre un error durante una llamada a la API, se envía una respuesta en este formato:
{
"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"
}
}
Todos los mensajes de error contienen los campos de error , type , message e instance . El objeto de details es opcional.
| Campo | Descripción |
|---|---|
error | Formato de mensaje de error corto. |
type | Proporciona una URL con información detallada sobre la condición de error (esta página). |
message | Formato de mensaje de error largo que puede usar variables para proporcionar detalles adicionales. Cuando se incluye una variable en el mensaje, aparecerá en el objeto de details . |
instance | Una cadena de texto que contiene un identificador de error que es único para cada llamada individual. Es posible que le pidamos el número de instancia si informa un problema con el servicio. |
details | Opcional. Contiene variables que se insertan en el message . Los mensajes pueden contener múltiples variables. |
Para obtener información sobre errores no relacionados con la API de Nest, consulte Otros códigos y mensajes de error .
Obstruido
Se superó el límite de velocidad .
| Parámetros | |
|---|---|
| Código de estado HTTP: 429 Demasiadas solicitudes | |
error | Obstruido |
type | https://developers.nest.com/reference/error-messages#blocked |
message | Obstruido |
No se puede activar el ventilador durante el apagado de seguridad de humo / co
El cierre de emergencia está en vigor. Las llamadas a la API no se aceptan hasta que se restaure el funcionamiento normal.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | No se puede activar el ventilador durante el apagado de seguridad de humo / co |
type | https://developers.nest.com/reference/error-messages#safety-shutoff-on |
message | No se puede activar el ventilador durante el apagado de seguridad de humo / co |
No se puede cambiar el estado Ausente mientras la calefacción de emergencia está encendida
El producto intentó cambiar el estado Ausente mientras la calefacción de emergencia estaba encendida.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | No se puede cambiar el estado Ausente mientras la calefacción de emergencia está encendida |
type | https://developers.nest.com/reference/error-messages#emergency-heat-is-on |
message | No se puede cambiar el estado Ausente mientras la calefacción de emergencia está encendida |
No se puede cambiar el modo HVAC durante eventos de ahorro de energía
Está en vigor un evento de ahorro de energía definido por un socio energético de Nest. Las llamadas a la API se rechazan hasta que finaliza el evento de ahorro de energía.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | No se puede cambiar el modo HVAC durante eventos de ahorro de energía |
type | https://developers.nest.com/reference/error-messages#energy-saving-event-on |
message | No se puede cambiar el modo HVAC durante eventos de ahorro de energía |
No se puede cambiar el modo HVAC
El modo es incompatible con la solicitud.
Por ejemplo, puede recibir este mensaje si:
- El sistema HVAC del termostato no admite el modo solicitado por su producto:
heat,cool,heat-cooloeco - El modo HVAC está configurado en
ecoy el producto intenta configurartarget_temperature
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | No se puede cambiar el modo HVAC al modo $mode ; HVAC no puede $action |
type | https://developers.nest.com/reference/error-messages#incompatible-mode |
message | No se puede cambiar el modo HVAC al modo $mode ; HVAC no puede $action |
details | $mode |
No se puede cambiar el modo HVAC mientras el bloqueo del termostato está habilitado
El usuario debe desbloquear el termostato antes de que un producto pueda escribir datos.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | No se puede cambiar el modo HVAC mientras el bloqueo del termostato está habilitado |
type | https://developers.nest.com/reference/error-messages#lock-enabled |
message | No se puede cambiar el modo HVAC mientras el bloqueo del termostato está habilitado |
No se pueden configurar las temperaturas C y F simultáneamente
El producto intentó establecer las temperaturas objetivo en grados Celsius y Fahrenheit al mismo tiempo. Un producto debe establecer solo la temperatura objetivo especificada por temperature_scale (C / F).
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | No se pueden configurar las temperaturas C y F simultáneamente |
type | https://developers.nest.com/reference/error-messages#multiple-value-changes |
message | No se pueden configurar las temperaturas C y F simultáneamente |
No se puede activar / desactivar fan_timer_active debido a un modo incompatible
El ventilador del sistema HVAC ya está activado (ya sea manualmente por el usuario o en un horario, o debido a un ciclo de calefacción / refrigeración HVAC).
Si no obtiene el resultado esperado, lo más probable es que se deba a que el dispositivo tiene un comportamiento integrado que no podemos anular a través de la API.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | No se puede activar / desactivar fan_timer_active debido al modo incompatible $mode |
type | https://developers.nest.com/reference/error-messages#incompatible-fan-mode |
message | No se puede activar / desactivar fan_timer_active debido al modo incompatible $mode |
details | $mode |
No se puede establecer fan_timer_duration en el valor seleccionado
El producto intentó establecer fan_timer_duration en un valor no válido. Consulte fan_timer_duration para obtener una lista de valores válidos.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | No se puede establecer fan_timer_duration en el valor seleccionado. Consulte la referencia de API para conocer los valores permitidos. |
type | https://developers.nest.com/reference/error-messages#invalid-fan-timer-duration |
message | No se puede establecer fan_timer_duration en el valor seleccionado. Consulte la referencia de API para conocer los valores permitidos. |
No se puede establecer la temperatura baja objetivo más alta que la temperatura alta objetivo
El termostato está en modo heat-cool y el producto intentó establecer una temperatura objetivo baja / alta que está fuera del rango. Por ejemplo, el producto intentó establecer target_temperature_low_c en 25 ° C cuando target_temperature_high_c es 24 ° C.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | No se puede establecer la temperatura baja objetivo $lowTemp más alta que la temperatura alta objetivo $highTemp |
type | https://developers.nest.com/reference/error-messages#low-high-error |
message | No se puede establecer la temperatura baja objetivo $lowTemp más alta que la temperatura alta objetivo $highTemp |
details | $lowTemp |
No se puede establecer la temperatura objetivo a menos de N grados C / F
El producto intentó establecer un valor de temperatura objetivo demasiado cerca de la temperatura alta / baja objetivo (por ejemplo, target_temperature_high_f ).
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | No se puede establecer la temperatura objetivo a menos de N grados C / F |
type | https://developers.nest.com/reference/error-messages#range-error |
message | No se puede establecer la temperatura objetivo a menos de $min grados $scale |
details | $min$scale |
No se puede establecer target_temperature mientras el modo es $ modo
El termostato o la estructura se encuentran actualmente en un modo que no admite solicitudes de API.
Por ejemplo, no puede establecer target_temperature_f o target_temperature_c cuando el sistema HVAC está off o en modo heat-cool . El valor no se puede cambiar hasta que el termostato / estructura vuelva a un modo no restringido.
En este mensaje, $fieldName puede ser cualquiera de los valores de temperatura objetivo y $mode puede ser cualquiera de: eco , emer_heat_enable , heat-cool , heat , cool , off , hvac_safety_shutoff_active .
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | No se puede establecer target_temperature mientras el modo es $mode |
type | https://developers.nest.com/reference/error-messages#mode-error |
message | No se puede establecer $fieldName mientras el modo es $mode |
details | $fieldName |
Se requiere una actualización del firmware del dispositivo antes de poder cambiar el modo HVAC
El dispositivo debe actualizarse a la versión de firmware actual para poder configurar las Temperaturas Eco.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | Se requiere una actualización del firmware del dispositivo antes de poder cambiar el modo HVAC. Las actualizaciones son automáticas, generalmente dentro de una semana después del lanzamiento. |
type | https://developers.nest.com/reference/error-messages#unsupported-firmware-version |
message | Se requiere una actualización del firmware del dispositivo antes de poder cambiar el modo HVAC. Las actualizaciones son automáticas, generalmente dentro de una semana después del lanzamiento. |
Error al validar los campos WWN
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | Error al validar los campos WWN: $error |
type | https://developers.nest.com/reference/error-messages#where-id-internal |
message | Error al validar los campos WWN: $error |
details | $error |
ETA está en el pasado
El tiempo de ETA especificado está en el pasado (antes de AHORA). Para obtener más información sobre cómo realizar llamadas ETA, consulte la Guía Ausente y ETA .
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | ETA está en el pasado: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime |
type | https://developers.nest.com/reference/error-messages#eta-in-the-past |
message | ETA está en el pasado: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime |
details | $estimatedArrivalTime |
ETA está demasiado lejos en el futuro
El tiempo ETA especificado no puede ser superior a 8 horas en el futuro. Para obtener más información sobre cómo realizar llamadas ETA, consulte la Guía de visitantes y ETA .
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | La ETA está demasiado lejos en el futuro |
type | https://developers.nest.com/reference/error-messages#eta-too-far-in-the-future |
message | La ETA está demasiado lejos en el futuro |
fan_timer_active no establecido
fan_timer_active no está definido.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | fan_timer_active no establecido |
type | https://developers.nest.com/reference/error-messages#fan-timer-active-value-missing |
message | fan_timer_active no establecido |
Prohibido
Las credenciales que se utilizan para acceder al servicio Nest no son válidas.
| Parámetros | |
|---|---|
| Código de estado HTTP: 403 prohibido | |
error | Prohibido |
type | https://developers.nest.com/reference/error-messages#forbidden |
message | Prohibido |
Error interno
| Parámetros | |
|---|---|
| Código de estado HTTP: 500 Error interno del servidor | |
error | Error interno |
type | https://developers.nest.com/reference/error-messages#internal-error |
message | Error interno |
ID de cámara no válido
La camera-id no es válida.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | ID de cámara no válido $id |
type | https://developers.nest.com/reference/error-messages#invalid-camera-id |
message | Identificación de cámara no válida: $id |
details | $id |
Se envió contenido no válido
La llamada tiene contenido no válido. Por ejemplo, usar "sí" en lugar de "verdadero" para una variable booleana.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | Se envió contenido no válido |
type | https://developers.nest.com/reference/error-messages#invalid-content-sent |
message | Se envió contenido no válido |
Ruta de fragmento no válida
Parte de la ruta de la solicitud no es válida. Por ejemplo, el nombre de un objeto o campo puede estar mal escrito.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | $requestPath fragmento no $requestPath : $requestPath |
type | https://developers.nest.com/reference/error-messages#invalid-fragment |
message | $requestPath fragmento no $requestPath : $requestPath |
details | $requestPath |
Modo HVAC no válido
El sistema HVAC del termostato no admite el modo solicitado por el producto: heat , cool o heat-cool .
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | Modo HVAC no válido: $mode |
type | https://developers.nest.com/reference/error-messages#invalid-mode |
message | Modo HVAC no válido: $mode |
details | $mode |
ID de alarma de humo + co no válido
El smoke_co_alarm_id no es válido.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | ID de alarma de humo + co no válido $id |
type | https://developers.nest.com/reference/error-messages#invalid-smoke-co-alarm-id |
message | ID de alarma de humo + co no válido: $id |
details | $id |
ID de estructura no válido
structure_id no es válido.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | ID de estructura no válido $id |
type | https://developers.nest.com/reference/error-messages#invalid-structure-id |
message | ID de estructura no válido: $id |
details | $id |
ID de termostato no válido
El thermostat_id no es válido.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | ID de termostato no válido $id |
type | https://developers.nest.com/reference/error-messages#invalid-thermostat-id |
message | ID de termostato no válido: $id |
details | $id |
Valor no válido para Ausente
Intentó establecer un valor no válido para away .
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | Valor no válido para Ausente |
type | https://developers.nest.com/reference/error-messages#invalid-away-value |
message | Valor no válido: $value . Solo 'hogar' y 'lejos' son valores permitidos. |
details | $value |
is_streaming no es booleano
El producto intentó establecer el campo is-streaming en un valor no booleano.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | is_streaming no es booleano |
type | https://developers.nest.com/reference/error-messages#invalid-is-stream-format |
message | is_streaming no es booleano |
La etiqueta debe tener menos de 256 caracteres
El producto intentó crear una etiqueta de termostato con más de 256 caracteres.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | La etiqueta debe tener menos de $max_label_length caracteres |
type | https://developers.nest.com/reference/error-messages#max-label-length |
message | La etiqueta debe tener menos de $max_label_length caracteres |
details | $max_label_length |
Max personalizado donde se superó el recuento
El producto intentó crear una costumbre wheres objeto más allá del máximo. La cantidad máxima permitida de objetos wheres personalizados es 32.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | Max personalizado donde se superó el recuento de $max_where_count |
type | https://developers.nest.com/reference/error-messages#max-where-count |
message | Máximo personalizado donde se superó el recuento de $max_where_count |
details | $max_where_count |
Max personalizado donde se excedió la longitud del nombre
El name where es demasiado largo. Recomendamos menos de 30 caracteres.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | Max personalizado donde se excedió la longitud del nombre de $max_custom_where_name_length |
type | https://developers.nest.com/reference/error-messages#max-where-name-length |
message | Max personalizado donde se excedió la longitud del nombre de $max_custom_where_name_length |
details | $max_custom_where_name_length |
Campo faltante
A la llamada le falta un parámetro obligatorio.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | Falta campo: $fieldName |
type | https://developers.nest.com/reference/error-messages#field-is-missing |
message | Falta campo: $fieldName |
details | $fieldName |
Falta el ID de lugar
where_id formato where_id .
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | Falta donde me identifiqué |
type | https://developers.nest.com/reference/error-messages#where-id-missing |
message | Falta donde me identifiqué |
Sin ventilador HVAC
El sistema HVAC no parece tener un ventilador independiente.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | Sin ventilador de hvac |
type | https://developers.nest.com/reference/error-messages#no-hvac-fan |
message | Sin ventilador de hvac |
Sin termostatos en línea
El termostato está actualmente fuera de línea. Una vez que se habilita el wi-fi, su producto debería recuperar el acceso.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | Sin termostatos en línea |
type | https://developers.nest.com/reference/error-messages#no-thermostats-online |
message | Sin termostatos en línea |
No hay dispositivos emparejados
Los dispositivos Nest del usuario no están emparejados con la cuenta Nest del usuario .
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | No hay dispositivos emparejados |
type | https://developers.nest.com/reference/error-messages#no-paired-devices |
message | No hay dispositivos emparejados |
No hay ETA válida para cancelar
El viaje no es válido y no se puede cancelar.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | No hay ETA válida para cancelar |
type | https://developers.nest.com/reference/error-messages#no-valid-eta-to-cancel |
message | No hay ETA válida para cancelar |
Sin permiso (s) de escritura para el (los) campo (s)
El cliente no tiene permiso de escritura para estos datos. Para obtener más información, consulte la descripción general de permisos .
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | Sin permiso (s) de escritura para los campos: $fields |
type | https://developers.nest.com/reference/error-messages#no-write-permission |
message | Sin permiso (s) de escritura para los campos: $fields |
details | $fields |
No es un tipo de solicitud válido
El tipo de solicitud no es válido. Por ejemplo, se realizó una llamada POST cuando se requiere una PUT.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | No es un tipo de solicitud válido: $requestType |
type | https://developers.nest.com/reference/error-messages#request-type-not-allowed |
message | No es un tipo de solicitud válido: $requestType |
details | $requestType |
Extraviado
La llamada intentó leer una ruta que no existe.
| Parámetros | |
|---|---|
| Código de estado HTTP: 404 no encontrado | |
error | Extraviado |
type | https://developers.nest.com/reference/error-messages#not-found |
message | Extraviado |
No en modo Ausente
La estructura no está en modo Ausente cuando se realiza una llamada ETA. Las llamadas ETA solo se aceptan cuando la estructura está configurada como Ausente.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | No en modo Ausente |
type | https://developers.nest.com/reference/error-messages#not-in-away-mode |
message | No en modo Ausente |
No se puede escribir
El campo en el que está intentando escribir es de solo lectura.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | No se puede escribir |
type | https://developers.nest.com/reference/error-messages#not-writable |
message | No se puede escribir |
Solo donde es necesario proporcionar el nombre
Se incluyeron campos adicionales en la llamada wheres .
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | Solo donde es necesario proporcionar el nombre |
type | https://developers.nest.com/reference/error-messages#extra-fields |
message | Solo donde es necesario proporcionar el nombre |
POST no es un tipo de solicitud válido
El tipo de solicitud no es válido. Por ejemplo, se realizó una llamada POST cuando se requiere una PUT.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | POST no es un tipo de solicitud válido |
type | https://developers.nest.com/reference/error-messages#invalid-request-type |
message | POST no es un tipo de solicitud válido |
Violación de esquema
Se produjo un error al emparejar dispositivos.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | Violación de esquema |
type | https://developers.nest.com/reference/error-messages#schema-violation-error |
message | Violación de esquema |
Servicio no disponible
| Parámetros | |
|---|---|
| Código de estado HTTP: 503 Servicio no disponible | |
error | Servicio no disponible |
type | https://developers.nest.com/reference/error-messages#service-unavailable |
message | Servicio no disponible |
La estructura ya tiene la cantidad máxima de dispositivos emparejados permitidos
La estructura ya tiene el número máximo de dispositivos permitidos .
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | La estructura ya tiene la cantidad máxima de dispositivos emparejados permitidos |
type | https://developers.nest.com/reference/error-messages#max-number-devices-error |
message | La estructura ya tiene la cantidad máxima de dispositivos emparejados permitidos |
La estructura no es propiedad del usuario
El structure_id no coincide con la cuenta de usuario del registro.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | La estructura no es propiedad del usuario. |
type | https://developers.nest.com/reference/error-messages#structure-ownership-error-uri |
message | La estructura no es propiedad del usuario. |
La temperatura C es demasiado alta para la temperatura de la cerradura
El termostato ha sido bloqueado por el usuario y el producto intentó establecer una temperatura objetivo en grados Celsius más alta que el rango de temperatura de bloqueo.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | Temperatura C $tempC es demasiado alta para la temperatura de bloqueo $highLockTemp |
type | https://developers.nest.com/reference/error-messages#high-c-value-4-lock |
message | Temperatura C $tempC es demasiado alta para la temperatura de bloqueo $highLockTemp |
details | $tempC |
La temperatura C es demasiado baja para la temperatura de la cerradura
El termostato ha sido bloqueado por el usuario y el producto intentó establecer una temperatura objetivo en grados Celsius más baja que el rango de temperatura de bloqueo.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | Temperatura C $tempC es demasiado baja para la temperatura de bloqueo $lowLockTemp |
type | https://developers.nest.com/reference/error-messages#low-c-value-4-lock |
message | Temperatura C $tempC es demasiado baja para la temperatura de bloqueo $lowLockTemp |
details | $tempC |
El valor de temperatura C es demasiado alto
El producto intentó establecer un valor de temperatura objetivo que es demasiado alto para una temperatura Celsius. Para conocer los rangos de temperatura permitidos en grados Celsius, consulte target_temperature_c .
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | El valor de temperatura C es demasiado alto: $tempC |
type | https://developers.nest.com/reference/error-messages#high-c-value |
message | El valor de temperatura C es demasiado alto: $tempC |
details | $tempC |
El valor de temperatura C es demasiado bajo
El producto intentó establecer un valor de temperatura objetivo que es demasiado bajo para una temperatura Celsius. Para conocer los rangos de temperatura permitidos en grados Celsius, consulte target_temperature_c .
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | El valor de temperatura C es demasiado bajo: $tempC |
type | https://developers.nest.com/reference/error-messages#low-c-value |
message | El valor de temperatura C es demasiado bajo: $tempC |
details | $tempC |
La temperatura F es demasiado alta para la temperatura de la cerradura
El termostato ha sido bloqueado por el usuario y el producto intentó establecer una temperatura objetivo en Fahrenheit más alta que el rango de temperatura de bloqueo.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | Temperatura F $tempF es demasiado alta para la temperatura de bloqueo $highLockTemp |
type | https://developers.nest.com/reference/error-messages#high-f-value-4-lock |
message | Temperatura F $tempF es demasiado alta para la temperatura de bloqueo $highLockTemp |
details | $tempF |
La temperatura F es demasiado baja para la temperatura de la cerradura
El termostato ha sido bloqueado por el usuario y el producto intentó establecer una temperatura objetivo Fahrenheit más baja que el rango de temperatura de bloqueo.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | Temperatura F $tempF es demasiado baja para la temperatura de bloqueo $lowLockTemp |
type | https://developers.nest.com/reference/error-messages#low-f-value-4-lock |
message | Temperatura F $tempF es demasiado baja para la temperatura de bloqueo $lowLockTemp |
details | $tempF |
El valor de temperatura F es demasiado alto
El producto intentó establecer un valor de temperatura objetivo que es demasiado alto para una temperatura Fahrenheit. Para los rangos de temperatura permitidos en Fahrenheit, consulte target_temperature_f .
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | El valor de temperatura F es demasiado alto: $tempF |
type | https://developers.nest.com/reference/error-messages#high-f-value |
message | El valor de temperatura F es demasiado alto: $tempF |
details | $tempF |
El valor de temperatura F es demasiado bajo
El producto intentó establecer un valor de temperatura objetivo que es demasiado bajo para una temperatura Fahrenheit. Para los rangos de temperatura permitidos en Fahrenheit, consulte target_temperature_f .
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | El valor de temperatura F es demasiado bajo: $tempF |
type | https://developers.nest.com/reference/error-messages#low-f-value |
message | El valor de temperatura F es demasiado bajo: $tempF |
details | $tempF |
La temperatura tiene un formato incorrecto
El producto intentó establecer una temperatura objetivo utilizando el formato de número incorrecto para la escala de temperature_scale elegida. Las temperaturas Celsius deben ser números enteros en incrementos de 0.5 grados (21.5) y las temperaturas Fahrenheit deben ser números enteros (72).
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | La temperatura $temp está en formato incorrecto |
type | https://developers.nest.com/reference/error-messages#format-error |
message | La temperatura $temp está en formato incorrecto |
details | $temp |
Los campos no se pueden modificar en la actualización
El producto intentó escribir en un campo de solo lectura.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | Los campos no se pueden modificar en la actualización: $fieldNames |
type | https://developers.nest.com/reference/error-messages#read-only-field-error |
message | Los campos no se pueden modificar en la actualización: $fieldNames |
details | $fieldNames |
Los campos deben usar el formato ISO 8601
El campo no está en formato ISO 8601 .
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | Los campos deben usar el formato ISO 8601: $fieldNames |
type | https://developers.nest.com/reference/error-messages#time-format-error |
message | Los campos deben usar el formato ISO 8601: $fieldNames |
details | $fieldNames |
El termostato no está en línea
El termostato está actualmente fuera de línea. Una vez que se habilita la conexión Wi-Fi, su producto debería recuperar el acceso.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | El termostato no está en línea |
type | https://developers.nest.com/reference/error-messages#not-online |
message | El termostato no está en línea |
Este viaje se anuló manualmente
El usuario ha anulado manualmente el viaje.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | Este viaje se anuló manualmente |
type | https://developers.nest.com/reference/error-messages#trip-manually-overidden |
message | Este viaje se anuló manualmente |
No se puede crear el ID de ubicación
Falta el objeto wheres . No se where_id valores where_id .
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | No se puede crear el id. |
type | https://developers.nest.com/reference/error-messages#wheres-missing |
message | No se puede crear el id. |
No autorizado
Ha fallado la autorización.
Un par de condiciones pueden generar este mensaje de error:
redireccionamientos incorrectos que ocurren cuando una implementación HTTP determinada no reenvía automáticamente el encabezado de autorización al URI redirigido. Para obtener más información, consulte Cómo manejar las redirecciones .
permisos incorrectos al intentar acceder a los puntos finales de la API. Por ejemplo, intentar leer un punto final de termostato cuando solo se seleccionan los permisos de la cámara para el cliente. Para obtener más información, consulte Cómo elegir permisos .
| Parámetros | |
|---|---|
| Código de estado HTTP: 401 no autorizado | |
error | No autorizado |
type | https://developers.nest.com/reference/error-messages#auth-error |
message | No autorizado |
Desconocido
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | desconocido |
type | https://developers.nest.com/reference/error-messages#unknown |
message | desconocido |
Proveedor / tipo de dispositivo desconocido
Proveedor / dispositivo no reconocido durante el emparejamiento de dispositivos.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | Proveedor / tipo de dispositivo desconocido |
type | https://developers.nest.com/reference/error-messages#unknown-vendor-device-type-error |
message | Proveedor / tipo de dispositivo desconocido |
El valor de $ fieldName es de tipo incorrecto
Se envió el tipo de datos incorrecto. Por ejemplo, enviar una cadena cuando se espera un valor booleano.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | El valor de $fieldName es de tipo incorrecto |
type | https://developers.nest.com/reference/error-messages#wrong-data-type |
message | El valor de $fieldName es de tipo incorrecto |
details | $fieldName |
Donde el nombre ya existe
El where_name el producto intentó establecer ya existe. Vuelve a intentarlo con un nombre nuevo.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | Donde el nombre $name ya existe |
type | https://developers.nest.com/reference/error-messages#where-name-exists |
message | Donde el nombre $name ya existe |
details | $name |
Donde no se proporciona el nombre
El where_name falta en la llamada.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | Donde no se proporciona el nombre |
type | https://developers.nest.com/reference/error-messages#where-name-missing |
message | Donde no se proporciona el nombre |
Donde el nombre es de longitud cero
El name donde no está definido (tiene cero caracteres).
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | Donde el nombre es de longitud cero |
type | https://developers.nest.com/reference/error-messages#zero-length-where-name |
message | Donde el nombre es de longitud cero |
Donde el nombre debe ser una cadena
Se envió el tipo de datos incorrecto para where_name . Por ejemplo, un número cuando se espera una cadena.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | Donde el nombre debe ser una cadena |
type | https://developers.nest.com/reference/error-messages#where-name-wrong-format |
message | Donde el nombre debe ser una cadena |
where_id no existe
El where_id no es válido.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | where_id no existe |
type | https://developers.nest.com/reference/error-messages#where-id-invalid |
message | where_id no existe |
details | $where_id |
where_id debe ser una cadena
El formato where_id no es válido. Por ejemplo, se envió un número en lugar de una cadena.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | where_id debe ser una cadena |
type | https://developers.nest.com/reference/error-messages#where-id-wrong-format |
message | where_id debe ser una cadena |
Otros códigos y mensajes de error
Códigos de error del dispositivo
Para códigos de error específicos del dispositivo y mensajes no relacionados con la API de Nest, consulte lo siguiente:
Códigos de error REST
Cuando realiza una llamada a la API REST, se devuelven códigos de estado HTTP comunes.
Mensajes de límite de tasa de REST
Cuando usa REST y envía demasiadas llamadas en un corto período de tiempo, puede recibir un código de estado de respuesta HTTP de 429 Demasiadas solicitudes.
Para obtener más información, consulte Límites de velocidad de datos .