En Google, luchamos por la equidad racial de la comunidad negra. Más información

Error de mensajes

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 error , type , message y instance campos. El details objeto 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 una variable se incluye en el mensaje, éste aparecerá en la details objeto.
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 las 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 Nido, consulte Otros códigos de error y mensajes .

Obstruido

El límite de velocidad se ha superado.

Parámetros
HTTP Status Code: 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

Parada de emergencia está en vigor. Las llamadas a la API no se aceptan hasta que se restablezca el funcionamiento normal.

Parámetros
HTTP Status Code: 400 Bad Request
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 trató de cambiar el estado de distancia, mientras que la calefacción de emergencia estaba en marcha.

Parámetros
HTTP Status Code: 400 Bad Request
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

Un evento de ahorro de energía definido por un socio energético Nido está en vigor. Las llamadas a la API se rechazan hasta que finaliza el evento de ahorro de energía.

Parámetros
HTTP Status Code: 400 Bad Request
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:

  • Sistema de climatización del termostato no soporta el modo solicitado por su producto: heat , cool , heat-cool , o eco
  • El modo de climatización se establece en eco y los intentos de productos para configurar target_temperature
Parámetros
HTTP Status Code: 400 Bad Request
error No se puede cambiar el modo de climatización a $mode ; HVAC no puede $action
type https://developers.nest.com/reference/error-messages#incompatible-mode
message No se puede cambiar el modo de climatización a $mode ; HVAC no puede $action
details $mode
$action

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 puede escribir datos.

Parámetros
HTTP Status Code: 400 Bad Request
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 fijar sólo la temperatura de destino especificado por el temperature_scale (C / F).

Parámetros
HTTP Status Code: 400 Bad Request
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
HTTP Status Code: 400 Bad Request
error No se puede establecer fan_timer_active de encendido / apagado debido al modo incompatibles $mode
type https://developers.nest.com/reference/error-messages#incompatible-fan-mode
message No se puede establecer fan_timer_active de encendido / apagado debido al modo incompatibles $mode
details $mode

No se puede establecer fan_timer_duration en el valor seleccionado

El producto tratado de establecer fan_timer_duration a un valor no válido. Ver fan_timer_duration para obtener una lista de valores válidos.

Parámetros
HTTP Status Code: 400 Bad Request
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 heat-cool modo, y el producto intentó establecer una temperatura objetivo bajo / alto que está fuera de la gama. Por ejemplo, el producto tratado de establecer target_temperature_low_c a 25 ° C cuando target_temperature_high_c es de 24 ° C.

Parámetros
HTTP Status Code: 400 Bad Request
error No se puede establecer nominal de la temperatura baja $lowTemp más alta que la temperatura objetivo de alto $highTemp
type https://developers.nest.com/reference/error-messages#low-high-error
message No se puede establecer nominal de la temperatura baja $lowTemp más alta que la temperatura objetivo de alto $highTemp
details $lowTemp
$highTemp

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 del objetivo de alta / baja temperatura (por ejemplo, target_temperature_high_f ).

Parámetros
HTTP Status Code: 400 Bad Request
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 blanco 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 se puede establecer target_temperature_f o target_temperature_c cuando el sistema de climatización está off o en heat-cool de modo. 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 la temperatura objetivo y $mode puede ser cualquiera de: eco , emer_heat_enable , heat-cool , heat , cool , off , hvac_safety_shutoff_active .

Parámetros
HTTP Status Code: 400 Bad Request
error No se puede establecer target_temperature mientras que el modo es $mode
type https://developers.nest.com/reference/error-messages#mode-error
message No se puede establecer $fieldName mientras que el modo es $mode
details $fieldName
$mode

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
HTTP Status Code: 400 Bad Request
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
HTTP Status Code: 400 Bad Request
error Error mientras que los campos de WWN validación: $error
type https://developers.nest.com/reference/error-messages#where-id-internal
message Error mientras que los campos de WWN validación: $error
details $error

ETA está en el pasado

El tiempo de ETA especificado está en el pasado (antes de NOW). Para obtener más información sobre cómo realizar llamadas de ETA, ver la distancia y guía ETA .

Parámetros
HTTP Status Code: 400 Bad Request
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
$currentTime

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 de ETA, ver la distancia y guía ETA .

Parámetros
HTTP Status Code: 400 Bad Request
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
HTTP Status Code: 400 Bad Request
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
HTTP Status Code: 403 Forbidden
error Prohibido
type https://developers.nest.com/reference/error-messages#forbidden
message Prohibido

Error interno

Parámetros
Código de estado HTTP: Error 500 Internal Server
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álido.

Parámetros
HTTP Status Code: 400 Bad Request
error Cámara ID no válida $id
type https://developers.nest.com/reference/error-messages#invalid-camera-id
message Inválida cámara Identificación: $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
HTTP Status Code: 400 Bad Request
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 fragmentos no válida

Parte de la ruta de solicitud no es válida. Por ejemplo, el nombre de un objeto o campo puede estar mal escrito.

Parámetros
HTTP Status Code: 400 Bad Request
error Ruta fragmento no válido: $requestPath
type https://developers.nest.com/reference/error-messages#invalid-fragment
message Ruta fragmento no válido: $requestPath
details $requestPath

Modo HVAC no válido

Sistema de climatización del termostato no soporta el modo solicitado por el producto: heat , cool o heat-cool .

Parámetros
HTTP Status Code: 400 Bad Request
error El modo de climatización no válido: $mode
type https://developers.nest.com/reference/error-messages#invalid-mode
message El modo de climatización 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
HTTP Status Code: 400 Bad Request
error Humo no válida + co alarma de Identificación $id
type https://developers.nest.com/reference/error-messages#invalid-smoke-co-alarm-id
message Humo no válida + co alarma id: $id
details $id

ID de estructura no válido

El structure_id no es válido.

Parámetros
HTTP Status Code: 400 Bad Request
error Estructura ID no válida $id
type https://developers.nest.com/reference/error-messages#invalid-structure-id
message Estructura ID no válida: $id
details $id

ID de termostato no válido

El thermostat_id no es válido.

Parámetros
HTTP Status Code: 400 Bad Request
error Termostato ID no válida $id
type https://developers.nest.com/reference/error-messages#invalid-thermostat-id
message Inválida termostato Identificación: $id
details $id

Valor no válido para Ausente

Ha intentado ajustar un valor no válido para la away .

Parámetros
HTTP Status Code: 400 Bad Request
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 is-streaming campo para un no-booleano.

Parámetros
HTTP Status Code: Solicitud incorrecta 400
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 ha intentado crear un sello termostato con más de 256 caracteres.

Parámetros
HTTP Status Code: 400 Bad Request
error La etiqueta debe ser inferior a $max_label_length caracteres
type https://developers.nest.com/reference/error-messages#max-label-length
message La etiqueta debe ser inferior a $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. El número máximo de encargo wheres objetos permitidos es de 32.

Parámetros
HTTP Status Code: 400 Bad Request
error Costumbre Max, donde el recuento de $max_where_count superó
type https://developers.nest.com/reference/error-messages#max-where-count
message Costumbre Max, donde el recuento de $max_where_count superó
details $max_where_count

Max personalizado donde se excedió la longitud del nombre

El donde name es demasiado largo. Recomendamos menos de 30 caracteres.

Parámetros
HTTP Status Code: 400 Bad Request
error Costumbre Max, donde la longitud del nombre de $max_custom_where_name_length superó
type https://developers.nest.com/reference/error-messages#max-where-name-length
message Costumbre Max, donde la longitud del nombre de $max_custom_where_name_length superó
details $max_custom_where_name_length

Campo faltante

A la llamada le falta un parámetro obligatorio.

Parámetros
HTTP Status Code: 400 Bad Request
error Falta el campo: $fieldName
type https://developers.nest.com/reference/error-messages#field-is-missing
message Falta el campo: $fieldName
details $fieldName

Falta el ID de lugar

El where_id aparece formato.

Parámetros
HTTP Status Code: 400 Bad Request
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
HTTP Status Code: 400 Bad Request
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 la conexión Wi-Fi, su producto debería recuperar el acceso.

Parámetros
HTTP Status Code: 400 Bad Request
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

Dispositivos Nest del usuario se no emparejados con cuenta de Nest del usuario .

Parámetros
HTTP Status Code: 400 Bad Request
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
HTTP Status Code: 400 Bad Request
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
HTTP Status Code: 400 Bad Request
error No escriba su permiso (s) para el campo (s): $fields
type https://developers.nest.com/reference/error-messages#no-write-permission
message No escriba su permiso (s) para el 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 una PUT.

Parámetros
HTTP Status Code: 400 Bad Request
error No es un tipo de petición válida: $requestType
type https://developers.nest.com/reference/error-messages#request-type-not-allowed
message No es un tipo de petición válida: $requestType
details $requestType

Extraviado

La llamada intentó leer una ruta que no existe.

Parámetros
HTTP Status Code: 404 Not Found
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. ETA llamadas sólo se aceptan cuando la estructura se ajusta a Ausente.

Parámetros
HTTP Status Code: 400 Bad Request
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
HTTP Status Code: 400 Bad Request
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

Campos adicionales se incluyeron en el wheres llamada.

Parámetros
HTTP Status Code: 400 Bad Request
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
HTTP Status Code: 400 Bad Request
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
HTTP Status Code: 400 Bad Request
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
HTTP Status Code: 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
HTTP Status Code: 400 Bad Request
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
HTTP Status Code: 400 Bad Request
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 se ha bloqueado por el usuario y el producto tratado de establecer una temperatura objetivo Celsius más alta que el rango de temperatura de bloqueo.

Parámetros
HTTP Status Code: 400 Bad Request
error Temperatura C $tempC es demasiado alto 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 alto para la temperatura de bloqueo $highLockTemp
details $tempC
$highLockTemp

La temperatura C es demasiado baja para la temperatura de la cerradura

El termostato se ha bloqueado por el usuario y el producto tratado de establecer una temperatura objetivo Celsius más baja que el rango de temperatura de bloqueo.

Parámetros
HTTP Status Code: 400 Bad Request
error C Temperatura de $tempC es demasiado bajo 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 bajo para la temperatura de bloqueo $lowLockTemp
details $tempC
$lowLockTemp

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 intervalos de temperatura permitidas en Celsius ver target_temperature_c .

Parámetros
HTTP Status Code: 400 Bad Request
error Valor de temperatura C es demasiado alto: $tempC
type https://developers.nest.com/reference/error-messages#high-c-value
message 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 intervalos de temperatura permitidas en Celsius ver target_temperature_c .

Parámetros
HTTP Status Code: 400 Bad Request
error Valor de temperatura C es demasiado baja: $tempC
type https://developers.nest.com/reference/error-messages#low-c-value
message Valor de temperatura C es demasiado baja: $tempC
details $tempC

La temperatura F es demasiado alta para la temperatura de la cerradura

El termostato se ha bloqueado por el usuario y el producto tratado de establecer una temperatura objetivo Fahrenheit más alto que el rango de temperatura de bloqueo.

Parámetros
HTTP Status Code: 400 Bad Request
error Temperatura F $tempF es demasiado alto 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 alto para la temperatura de bloqueo $highLockTemp
details $tempF
$highLockTemp

La temperatura F es demasiado baja para la temperatura de la cerradura

El termostato se ha bloqueado por el usuario y el producto tratado de establecer una temperatura objetivo Fahrenheit más baja que el rango de temperatura de bloqueo.

Parámetros
HTTP Status Code: 400 Bad Request
error Temperatura F $tempF es demasiado bajo 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 bajo para la temperatura de bloqueo $lowLockTemp
details $tempF
$lowLockTemp

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 intervalos de temperatura permitidas en Fahrenheit ver target_temperature_f .

Parámetros
HTTP Status Code: 400 Bad Request
error F valor de la temperatura es demasiado alta: $tempF
type https://developers.nest.com/reference/error-messages#high-f-value
message F valor de la temperatura es demasiado alta: $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 intervalos de temperatura permitidas en Fahrenheit ver target_temperature_f .

Parámetros
HTTP Status Code: 400 Bad Request
error F valor de la temperatura es demasiado baja: $tempF
type https://developers.nest.com/reference/error-messages#low-f-value
message F valor de la temperatura es demasiado baja: $tempF
details $tempF

La temperatura tiene un formato incorrecto

El producto intentó establecer una temperatura de destino con el formato de número equivocado para el elegido temperature_scale . 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
HTTP Status Code: 400 Bad Request
error Temperatura $temp está en un formato incorrecto
type https://developers.nest.com/reference/error-messages#format-error
message Temperatura $temp está en un 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
HTTP Status Code: 400 Bad Request
error El campo (s) no se puede modificar en la actualización: $fieldNames
type https://developers.nest.com/reference/error-messages#read-only-field-error
message El campo (s) no se puede modificar en la actualización: $fieldNames
details $fieldNames

Los campos deben usar el formato ISO 8601

El campo no está en la norma ISO 8601 de formato.

Parámetros
HTTP Status Code: 400 Bad Request
error El campo (s) se debe utilizar el formato ISO 8601: $fieldNames
type https://developers.nest.com/reference/error-messages#time-format-error
message El campo (s) se debe utilizar 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
HTTP Status Code: 400 Bad Request
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
HTTP Status Code: 400 Bad Request
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

El wheres objeto no se encuentra. Sin where_id se definen valores.

Parámetros
HTTP Status Code: 400 Bad Request
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, vea 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 los permisos .

Parámetros
HTTP Status Code: 401 Unauthorized
error No autorizado
type https://developers.nest.com/reference/error-messages#auth-error
message No autorizado

Desconocido

Parámetros
HTTP Status Code: 400 Bad Request
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
HTTP Status Code: 400 Bad Request
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
HTTP Status Code: 400 Bad Request
error Valor de $fieldName es de tipo incorrecto
type https://developers.nest.com/reference/error-messages#wrong-data-type
message Valor de $fieldName es de tipo incorrecto
details $fieldName

Donde el nombre ya existe

El where_name el producto tratado de conjunto ya existe. Vuelve a intentarlo con un nombre nuevo.

Parámetros
HTTP Status Code: 400 Bad Request
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 no se encuentra en la llamada.

Parámetros
HTTP Status Code: 400 Bad Request
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 donde name no está definido (tiene cero caracteres).

Parámetros
HTTP Status Code: 400 Bad Request
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

El tipo de datos incorrecto fue enviado para la where_name . Por ejemplo, un número cuando se espera una cadena.

Parámetros
HTTP Status Code: 400 Bad Request
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
HTTP Status Code: 400 Bad Request
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 where_id formato no es válido. Por ejemplo, se envió un número en lugar de una cadena.

Parámetros
HTTP Status Code: 400 Bad Request
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

Al utilizar REST y enviarle 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 .