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 se produce 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 a 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 solicitemos 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 los errores no relacionados con la API de Nest, consulte Otros códigos y mensajes de error .
Obstruido
Se ha excedido 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 humo / co seguridad
El cierre de emergencia está en vigor. Las llamadas a la API no se aceptan hasta que se restablezca el funcionamiento normal.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | No se puede activar el ventilador durante el apagado de humo / co seguridad |
type | https://developers.nest.com/reference/error-messages#safety-shutoff-on |
message | No se puede activar el ventilador durante el apagado de humo / co seguridad |
No se puede cambiar el estado Ausente mientras el calor de emergencia está encendido
El producto intentó cambiar el estado Ausente mientras el Calor de emergencia estaba encendido.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | No se puede cambiar el estado Ausente mientras el calor de emergencia está encendido |
type | https://developers.nest.com/reference/error-messages#emergency-heat-is-on |
message | No se puede cambiar el estado Ausente mientras el calor de emergencia está encendido |
No se puede cambiar el modo HVAC durante los eventos de ahorro de energía.
Un evento de ahorro de energía definido por un socio de Nest Energy está en vigor. 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 los 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 los 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 establecer latarget_temperature
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | No se puede cambiar el modo HVAC a $mode ; HVAC no puede $action |
type | https://developers.nest.com/reference/error-messages#incompatible-mode |
message | No se puede cambiar el modo HVAC a $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 temperaturas objetivo de Celsius y Fahrenheit al mismo tiempo. Un producto debe establecer solo la temperatura objetivo especificada por la 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 al 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 el dispositivo tenga un comportamiento incorporado 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 la API para ver 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 la API para ver 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 más cerca de N grados C / F
El producto intentó establecer un valor de temperatura objetivo demasiado cercano a 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 más cerca de N grados C / F |
type | https://developers.nest.com/reference/error-messages#range-error |
message | No se puede establecer la temperatura objetivo más cerca de $min grados $scale |
details | $min $scale |
No se puede establecer target_temperature mientras el modo es $ mode
El termostato o la estructura se encuentra 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 la 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 configurar las temperaturas ecológicas.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | Se requiere la 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 la 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 campos WWN
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | Error al validar campos WWN: $error |
type | https://developers.nest.com/reference/error-messages#where-id-internal |
message | Error al validar campos WWN: $error |
details | $error |
ETA está en el pasado
El tiempo 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 de Away 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 más de 8 horas en el futuro. Para obtener más información sobre cómo realizar llamadas ETA, consulte la Guía de Away 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 inválida
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 | ID de cámara no válida: $id |
details | $id |
Contenido inválido enviado
La llamada contiene contenido no válido. Por ejemplo, usando "yes" en lugar de "true" para una variable booleana.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | Contenido inválido enviado |
type | https://developers.nest.com/reference/error-messages#invalid-content-sent |
message | Contenido inválido enviado |
Ruta de fragmento inválida
Parte de la ruta de solicitud no es válida. Por ejemplo, un nombre de 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 de climatización 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 de climatización no válido: $mode |
type | https://developers.nest.com/reference/error-messages#invalid-mode |
message | Modo de climatización no válido: $mode |
details | $mode |
ID de alarma de humo + co no válida
smoke_co_alarm_id no es válido.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | Identificación de alarma de humo + co inválida $id |
type | https://developers.nest.com/reference/error-messages#invalid-smoke-co-alarm-id |
message | Identificación de alarma de humo + co no válida: $id |
details | $id |
ID de estructura inválida
structure_id no es válido.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | ID de estructura no válida $id |
type | https://developers.nest.com/reference/error-messages#invalid-structure-id |
message | ID de estructura no válida: $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 del termostato no válido $id |
type | https://developers.nest.com/reference/error-messages#invalid-thermostat-id |
message | ID del termostato no válido: $id |
details | $id |
Valor inválido para Ausente
Intentaste establecer un valor no válido para away .
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | Valor invá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 un objeto wheres personalizado más allá del máximo. El número máximo de encargo wheres objetos permitidos es de 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 | Max personalizado donde se superó el recuento de $max_where_count |
details | $max_where_count |
Max personalizado donde la longitud del nombre excedió
El name donde es demasiado largo. Recomendamos menos de 30 caracteres.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | $max_custom_where_name_length máximo 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_custom_where_name_length máximo donde se excedió la longitud del nombre de $max_custom_where_name_length |
details | $max_custom_where_name_length |
Campo perdido
A la llamada le falta un parámetro requerido.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | Falta el campo: $fieldName |
type | https://developers.nest.com/reference/error-messages#field-is-missing |
message | Falta el campo: $fieldName |
details | $fieldName |
Falta la identificación de Where
where_id formato where_id .
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | Missing Where Id |
type | https://developers.nest.com/reference/error-messages#where-id-missing |
message | Missing Where Id |
No hay ventilador HVAC
El sistema HVAC no parece tener un ventilador independiente.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | No hay ventilador hvac |
type | https://developers.nest.com/reference/error-messages#no-hvac-fan |
message | No hay ventilador hvac |
No hay termostatos en línea.
El termostato está actualmente fuera de línea. Después de que se habilite el wi-fi, su producto debería recuperar el acceso.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | No hay termostatos en línea. |
type | https://developers.nest.com/reference/error-messages#no-thermostats-online |
message | No hay termostatos en línea. |
No hay dispositivos emparejados
Los dispositivos Nest del usuario no están vinculados 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 campo (s)
El cliente no tiene permiso de escritura para estos datos. Para obtener más información, consulte la Descripción general de los permisos .
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | Sin permiso (s) de escritura para campo (s): $fields |
type | https://developers.nest.com/reference/error-messages#no-write-permission |
message | Sin permiso (s) de escritura para campo (s): $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 un 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 escribible
El campo en el que intenta escribir es de solo lectura.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | No escribible |
type | https://developers.nest.com/reference/error-messages#not-writable |
message | No escribible |
Solo donde se debe proporcionar el nombre
Se incluyeron campos adicionales en la llamada de wheres .
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | Solo donde se debe proporcionar el nombre |
type | https://developers.nest.com/reference/error-messages#extra-fields |
message | Solo donde se debe 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 un 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 |
Infracción de esquema
Se produjo un error al emparejar dispositivos.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | Infracción de esquema |
type | https://developers.nest.com/reference/error-messages#schema-violation-error |
message | Infracció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 un número máximo 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 un número máximo de dispositivos emparejados permitidos |
type | https://developers.nest.com/reference/error-messages#max-number-devices-error |
message | La estructura ya tiene un número máximo 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 bloqueo
El usuario ha bloqueado el termostato y el producto intentó establecer una temperatura objetivo Celsius más alta que el rango de temperatura de bloqueo.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | La 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 | La temperatura C $tempC es demasiado alta para la temperatura de bloqueo $highLockTemp |
details | $tempC |
La temperatura C es demasiado baja para la temperatura de bloqueo
El usuario ha bloqueado el termostato y el producto intentó establecer una temperatura objetivo Celsius más baja que el rango de temperatura de bloqueo.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | La 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 | La temperatura C $tempC es demasiado baja para la temperatura de bloqueo $lowLockTemp |
details | $tempC |
El valor de la temperatura C es demasiado alto
El producto intentó establecer un valor de temperatura objetivo que es demasiado alto para una temperatura Celsius. Para rangos de temperatura permitidos en grados Celsius, vea target_temperature_c .
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | El valor de la temperatura C es demasiado alto: $tempC |
type | https://developers.nest.com/reference/error-messages#high-c-value |
message | El valor de la temperatura C es demasiado alto: $tempC |
details | $tempC |
El valor de la temperatura C es demasiado bajo
El producto intentó establecer un valor de temperatura objetivo que es demasiado bajo para una temperatura Celsius. Para rangos de temperatura permitidos en grados Celsius, vea target_temperature_c .
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | El valor de la temperatura C es demasiado bajo: $tempC |
type | https://developers.nest.com/reference/error-messages#low-c-value |
message | El valor de la temperatura C es demasiado bajo: $tempC |
details | $tempC |
La temperatura F es demasiado alta para la temperatura de bloqueo
El usuario ha bloqueado el termostato y el producto intentó establecer una temperatura objetivo Fahrenheit más alta que el rango de temperatura de bloqueo.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | La 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 | La temperatura F $tempF es demasiado alta para la temperatura de bloqueo $highLockTemp |
details | $tempF |
La temperatura F es demasiado baja para la temperatura de bloqueo
El usuario ha bloqueado el termostato y el producto intentó establecer una temperatura objetivo de Fahrenheit inferior al rango de temperatura de bloqueo.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | La 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 | La temperatura F $tempF es demasiado baja para la temperatura de bloqueo $lowLockTemp |
details | $tempF |
El valor de la temperatura F es demasiado alto
El producto intentó establecer un valor de temperatura objetivo que es demasiado alto para una temperatura Fahrenheit. Para rangos de temperatura permitidos en Fahrenheit, vea target_temperature_f .
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | El valor de la temperatura F es demasiado alto: $tempF |
type | https://developers.nest.com/reference/error-messages#high-f-value |
message | El valor de la temperatura F es demasiado alto: $tempF |
details | $tempF |
El valor de la temperatura F es demasiado bajo
El producto intentó establecer un valor de temperatura objetivo que es demasiado bajo para una temperatura Fahrenheit. Para rangos de temperatura permitidos en Fahrenheit, vea target_temperature_f .
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | El valor de la temperatura F es demasiado bajo: $tempF |
type | https://developers.nest.com/reference/error-messages#low-f-value |
message | El valor de la temperatura F es demasiado bajo: $tempF |
details | $tempF |
La temperatura está en 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 deberían ser enteras en incrementos de 0.5 grados (21.5), y las temperaturas Fahrenheit deberían ser enteras (72).
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | Temperatura $temp está en formato incorrecto |
type | https://developers.nest.com/reference/error-messages#format-error |
message | 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. Después de que se habilite el 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 ha sido anulado manualmente
El usuario ha anulado manualmente el viaje.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | Este viaje ha sido anulado manualmente |
type | https://developers.nest.com/reference/error-messages#trip-manually-overidden |
message | Este viaje ha sido anulado manualmente |
No se puede crear donde ID
El wheres objeto no se encuentra. No se where_id valores where_id .
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | No se puede crear donde id |
type | https://developers.nest.com/reference/error-messages#wheres-missing |
message | No se puede crear donde id |
No autorizado
La autorización ha fallado.
Un par de condiciones pueden generar este mensaje de error:
redireccionamientos incorrectos que ocurren cuando una implementación HTTP dada 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 puntos finales API. Por ejemplo, intentar leer un punto final del 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 del dispositivo.
| 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. Intente nuevamente con un nuevo nombre.
| Parámetros | |
|---|---|
| Código de estado HTTP: 400 Solicitud incorrecta | |
error | Donde nombre $name ya existe |
type | https://developers.nest.com/reference/error-messages#where-name-exists |
message | Donde nombre $name ya existe |
details | $name |
Donde no se proporciona el nombre
El where_name encuentra 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 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 nombre debe ser una cadena |
type | https://developers.nest.com/reference/error-messages#where-name-wrong-format |
message | Donde nombre debe ser una cadena |
where_id no existe
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 de error y mensajes
Códigos de error del dispositivo
Para los códigos de error específicos del dispositivo y los 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 velocidad REST
Cuando utiliza 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 .