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

Mensajes de error

Las condiciones de error forman parte del ciclo de desarrollo y pueden variar desde fallas simples, como un parámetro no válido o faltante, hasta situaciones más complejas, como un estado inesperado o incluso una configuración relacionada con el dispositivo, que se debe resolver 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 error, type, message y instance. El objeto details es opcional.

Campo Descripción
error Formato breve de mensaje de error.
type Proporciona una URL a la información detallada sobre la condición del error (esta página).
message Es un 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 details.
instance Una string de texto que contiene un identificador de error que es único para cada llamada individual. Es posible que te solicitemos el número de instancia si informas un problema con el servicio.
details Opcional. Contiene variables que se insertan en message. Los mensajes pueden contener múltiples variables.

Para obtener más información sobre errores no relacionados con la API de Nest, consulta Otros códigos de error y mensajes.

Bloqueado

Se excedió el límite de frecuencia.

Parámetros
Código de estado HTTP: 429 Demasiadas solicitudes
errorBloqueado
typehttps://developers.nest.com/reference/error-messages#blocked
messageBloqueado

No se puede activar el ventilador durante el corte de seguridad por humo o monóxido de carbono

El Corte de emergencia está activo. Las llamadas a la API no se aceptan hasta que se restablece el funcionamiento normal.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorNo se puede activar el ventilador durante el corte de seguridad por humo o monóxido de carbono
typehttps://developers.nest.com/reference/error-messages#safety-shutoff-on
messageNo se puede activar el ventilador durante el corte de seguridad por humo o monóxido de carbono

No se puede cambiar el estado Ausente mientras el calefactor de emergencia está encendido

El producto intentó cambiar el estado Ausente mientras la opción Calefactor de emergencia estaba encendida.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorNo se puede cambiar el estado Ausente mientras el calefactor de emergencia está encendido
typehttps://developers.nest.com/reference/error-messages#emergency-heat-is-on
messageNo se puede cambiar el estado Ausente mientras el calefactor 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 energético de Nest está en vigor. Las llamadas a la API se rechazarán hasta que finalice el evento de ahorro de energía.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorNo se puede cambiar el modo HVAC durante los eventos de ahorro de energía
typehttps://developers.nest.com/reference/error-messages#energy-saving-event-on
messageNo se puede cambiar el modo HVAC durante los eventos de ahorro de energía

No se puede cambiar el modo HVAC

El modo no es compatible con la solicitud.

Por ejemplo, podrías recibir este mensaje si:

  • El sistema de HVAC del termostato no es compatible con el modo que solicita tu producto: heat, cool, heat-cool o eco
  • El modo HVAC se estableció en eco y el producto intenta configurar target_temperature
Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorNo se puede cambiar el modo de HVAC a $mode; HVAC no puede $action
typehttps://developers.nest.com/reference/error-messages#incompatible-mode
messageNo se puede cambiar el modo de HVAC 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 pueda escribir datos.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorNo se puede cambiar el modo HVAC mientras el bloqueo del termostato está habilitado
typehttps://developers.nest.com/reference/error-messages#lock-enabled
messageNo se puede cambiar el modo HVAC mientras el bloqueo del termostato está habilitado

No se pueden establecer temperaturas C y F al mismo tiempo

El producto intentó establecer temperaturas objetivo Celsius y Fahrenheit al mismo tiempo. Un producto solo debe establecer la temperatura final especificada por temperature_scale (C/F).

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorNo se pueden establecer temperaturas C y F al mismo tiempo
typehttps://developers.nest.com/reference/error-messages#multiple-value-changes
messageNo se pueden establecer temperaturas C y F al mismo tiempo

No se puede activar o desactivar fan_timer_active debido a un modo incompatible

El ventilador del sistema de HVAC ya está conectado (ya sea de forma manual o por un programa, o debido a un ciclo de calefacción/frío de HVAC).

Si no obtienes el resultado esperado, lo más probable es que el dispositivo tenga un comportamiento integrado que no podamos anular por medio de la API.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorNo se puede activar o desactivar fan_timer_active debido a un modo incompatible $mode
typehttps://developers.nest.com/reference/error-messages#incompatible-fan-mode
messageNo se puede activar o desactivar fan_timer_active debido a un modo incompatible $mode
details$mode

No se puede establecer fan_timer_duration en el valor seleccionado

El producto intentó configurar fan_timer_duration en un valor no válido. Consulta fan_timer_duration para obtener una lista de valores válidos.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorNo se puede establecer fan_timer_duration en el valor seleccionado. Consulta la referencia de la API para conocer los valores permitidos.
typehttps://developers.nest.com/reference/error-messages#invalid-fan-timer-duration
messageNo se puede establecer fan_timer_duration en el valor seleccionado. Consulta la referencia de la API para conocer los valores permitidos.

No se puede establecer una temperatura final mínima más alta que la máxima deseada

El termostato está en modo heat-cool, y el producto intentó establecer una temperatura final/baja que está fuera del rango. Por ejemplo, el producto intentó establecer target_temperature_low_c en 25 °C cuando target_temperature_high_c es de 24 °C.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorNo se puede establecer la temperatura mínima deseada $lowTemp más alta que la temperatura máxima deseada en $highTemp
typehttps://developers.nest.com/reference/error-messages#low-high-error
messageNo se puede establecer la temperatura mínima deseada $lowTemp más alta que la temperatura máxima deseada en $highTemp
details$lowTemp
$highTemp

No se puede establecer una temperatura final más cercana a N grados C/F

El producto intentó establecer una temperatura final demasiado cercana a la temperatura final/alta de destino (por ejemplo, target_temperature_high_f).

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorNo se puede establecer una temperatura final más cercana a N grados C/F
typehttps://developers.nest.com/reference/error-messages#range-error
messageNo se puede establecer una temperatura final más cercana a $min grados $scale
details$min
$scale

No se puede establecer target_temperature mientras el modo es $mode.

El termostato o la estructura se encuentran en un modo que no admite solicitudes a la API.

Por ejemplo, no puedes configurar target_temperature_f ni target_temperature_c cuando el sistema de HVAC está off o en modo heat-cool. No se podrá cambiar el valor hasta que el termostato o la estructura vuelvan a un modo no restringido.

En este mensaje,$fieldName puede ser cualquiera de los valores de temperatura de destino y $mode puede ser cualquiera de los siguientes: eco, emer_heat_enable, heat-cool, heat, cool, off, hvac_safety_shutoff_active.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorNo se puede establecer target_temperature mientras el modo está $mode
typehttps://developers.nest.com/reference/error-messages#mode-error
messageNo se puede establecer $fieldName mientras el modo está $mode
details$fieldName
$mode

Se debe actualizar el firmware del dispositivo para poder cambiar el modo HVAC

El dispositivo debe estar actualizado a la versión de firmware actual para establecer las Temperaturas Eco.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorSe requiere la actualización del firmware del dispositivo para poder cambiar el modo de HVAC. Las actualizaciones son automáticas, generalmente, una semana después de su lanzamiento.
typehttps://developers.nest.com/reference/error-messages#unsupported-firmware-version
messageSe requiere la actualización del firmware del dispositivo para poder cambiar el modo de HVAC. Las actualizaciones son automáticas, generalmente, una semana después de su lanzamiento.

Error al validar los campos WWN

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorError al validar los campos WWN: $error
typehttps://developers.nest.com/reference/error-messages#where-id-internal
messageError al validar los campos WWN: $error
details$error

ETA en el pasado

La hora de llegada estimada que se especificó es en el pasado (antes de HOY). Para obtener más información sobre cómo realizar llamadas de ETA, consulta la Guía de ETA y Ausente.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorETA es anterior: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime
typehttps://developers.nest.com/reference/error-messages#eta-in-the-past
messageETA es anterior: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime
details$estimatedArrivalTime
$currentTime

La hora de llegada es demasiado lejana

La hora de llegada estimada no puede ser superior a ocho horas en el futuro. Para obtener más información sobre cómo realizar llamadas de ETA, consulta la Guía de ETA y Ausente.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorLa fecha de llegada es demasiado lejana
typehttps://developers.nest.com/reference/error-messages#eta-too-far-in-the-future
messageLa fecha de llegada es demasiado lejana

No se estableció el parámetro ventilador_timer_active

fan_timer_active no está definido.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorNo se estableció el parámetro ventilador_timer_active
typehttps://developers.nest.com/reference/error-messages#fan-timer-active-value-missing
messageNo se estableció el parámetro ventilador_timer_active

Prohibido

Las credenciales que se usan para acceder al servicio de Nest no son válidas.

Parámetros
Código de estado HTTP: 403 Prohibido
errorProhibido
typehttps://developers.nest.com/reference/error-messages#forbidden
messageProhibido

Error interno

Parámetros
Código de estado HTTP: Error interno del servidor 500
errorError interno
typehttps://developers.nest.com/reference/error-messages#internal-error
messageError interno

ID de cámara no válido

El camera-id no es válido.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorID de cámara no válido $id
typehttps://developers.nest.com/reference/error-messages#invalid-camera-id
messageID de cámara no válido: $id
details$id

Se envió contenido no válido

La llamada incluye contenido no válido. Por ejemplo, usar "sí" en lugar de "verdadero" para una variable booleana.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorSe envió contenido no válido
typehttps://developers.nest.com/reference/error-messages#invalid-content-sent
messageSe envió contenido no válido

Ruta de fragmento no válida

Parte de la ruta de la solicitud no es válida. Por ejemplo, es posible que el nombre de un objeto o campo esté mal escrito.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorRuta de fragmento no válida: $requestPath
typehttps://developers.nest.com/reference/error-messages#invalid-fragment
messageRuta de fragmento no válida: $requestPath
details$requestPath

Modo de HVAC no válido

El sistema de HVAC del termostato no es compatible con el modo que solicita el producto: heat, cool o heat-cool.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorModo de HVAC no válido: $mode
typehttps://developers.nest.com/reference/error-messages#invalid-mode
messageModo de 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: Error 400 de solicitud incorrecta
errorID de alarma de humo/co $id no válido
typehttps://developers.nest.com/reference/error-messages#invalid-smoke-co-alarm-id
messageEl ID de la alarma de humo+co no es válido: $id
details$id

ID de estructura no válido

El structure_id no es válido.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorID de estructura no válido $id
typehttps://developers.nest.com/reference/error-messages#invalid-structure-id
messageID 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: Error 400 de solicitud incorrecta
errorID de termostato no válido $id
typehttps://developers.nest.com/reference/error-messages#invalid-thermostat-id
messageID de termostato no válido: $id
details$id

Valor no válido para Ausente

Intentaste establecer un valor no válido para away.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorValor no válido para Ausente
typehttps://developers.nest.com/reference/error-messages#invalid-away-value
messageValor no válido: $value. Solo se permiten los valores "En casa" y "Ausente".
details$value

is_streaming no es booleano

El producto intentó configurar el campo is-streaming en un valor no booleano.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
erroris_streaming no es booleano
typehttps://developers.nest.com/reference/error-messages#invalid-is-stream-format
messageis_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: Error 400 de solicitud incorrecta
errorLa etiqueta debe tener menos de $max_label_length caracteres
typehttps://developers.nest.com/reference/error-messages#max-label-length
messageLa etiqueta debe tener menos de $max_label_length caracteres
details$max_label_length

Cantidad personalizada de instancias máximas en las que se superó el límite

El producto intentó crear un objeto wheres personalizado más allá del máximo. La cantidad máxima de objetos wheres personalizados permitidos es 32.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorMáx. personalizado, donde se superó el recuento de $max_where_count
typehttps://developers.nest.com/reference/error-messages#max-where-count
messageMáx. personalizado, donde se superó el recuento de $max_where_count
details$max_where_count

Cantidad máxima de instancias personalizadas en las que se superó el nombre

En el que name es demasiado largo. Recomendamos usar menos de 30 caracteres.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorLa cantidad máxima personalizada es de $max_custom_where_name_length, cuando se supera el nombre
typehttps://developers.nest.com/reference/error-messages#max-where-name-length
messageLa cantidad máxima personalizada es de $max_custom_where_name_length, cuando se supera el nombre
details$max_custom_where_name_length

Falta el campo

A la llamada le falta un parámetro obligatorio.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorFalta el campo: $fieldName
typehttps://developers.nest.com/reference/error-messages#field-is-missing
messageFalta el campo: $fieldName
details$fieldName

Falta el ID de la ubicación.

Falta el formato where_id.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorFalta el ID del lugar
typehttps://developers.nest.com/reference/error-messages#where-id-missing
messageFalta el ID del lugar

No tiene ventilador de HVAC

El sistema de HVAC no parece tener un ventilador independiente.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorNo tiene ventilador de HVAC
typehttps://developers.nest.com/reference/error-messages#no-hvac-fan
messageNo tiene ventilador de HVAC

No hay termostatos en línea

El termostato no está conectado. Una vez que se habilite la conexión Wi-Fi, el producto debería volver a tener acceso.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorNo hay termostatos en línea
typehttps://developers.nest.com/reference/error-messages#no-thermostats-online
messageNo hay termostatos en línea

No hay dispositivos sincronizados

Los dispositivos Nest del usuario no están vinculados con su cuenta de Nest.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorNo hay dispositivos sincronizados
typehttps://developers.nest.com/reference/error-messages#no-paired-devices
messageNo hay dispositivos sincronizados

No hay un ETA válido para cancelar

El viaje no es válido y no se puede cancelar.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorNo hay un ETA válido para cancelar
typehttps://developers.nest.com/reference/error-messages#no-valid-eta-to-cancel
messageNo hay un ETA válido para cancelar

No hay permisos de escritura para los campos

El cliente no tiene permiso de escritura para estos datos. Para obtener más información, consulta la Descripción general de permisos.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorNo hay permisos de escritura para los campos: $fields
typehttps://developers.nest.com/reference/error-messages#no-write-permission
messageNo hay permisos de escritura para los campos: $fields
details$fields

El tipo de solicitud no es 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: Error 400 de solicitud incorrecta
errorEl tipo de solicitud no es válido: $requestType
typehttps://developers.nest.com/reference/error-messages#request-type-not-allowed
messageEl tipo de solicitud no es válido: $requestType
details$requestType

No encontrado

La llamada intentó leer una ruta que no existe.

Parámetros
Código de estado HTTP: No se encontró el error 404
errorNo encontrado
typehttps://developers.nest.com/reference/error-messages#not-found
messageNo encontrado

No está en modo Ausente

La estructura no está en modo Ausente cuando se realiza una llamada de ETA. Las llamadas de ETA solo se aceptan cuando la estructura está establecida en Ausente.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorNo está en modo Ausente
typehttps://developers.nest.com/reference/error-messages#not-in-away-mode
messageNo está en modo Ausente

No admite escritura

El campo en el que intentas escribir es de solo lectura.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorNo admite escritura
typehttps://developers.nest.com/reference/error-messages#not-writable
messageNo admite escritura

Solo se debe proporcionar el nombre

Se incluyeron campos adicionales en la llamada wheres.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorSolo se debe proporcionar el nombre
typehttps://developers.nest.com/reference/error-messages#extra-fields
messageSolo 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 una PUT.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorPOST no es un tipo de solicitud válido
typehttps://developers.nest.com/reference/error-messages#invalid-request-type
messagePOST no es un tipo de solicitud válido

Incumplimiento del esquema

Se produjo un error al sincronizar los dispositivos.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorIncumplimiento del esquema
typehttps://developers.nest.com/reference/error-messages#schema-violation-error
messageIncumplimiento del esquema

El servicio no está disponible

Parámetros
Código de estado HTTP: Servicio 503 no disponible
errorServicio no disponible
typehttps://developers.nest.com/reference/error-messages#service-unavailable
messageServicio no disponible

La estructura ya tiene la cantidad máxima de dispositivos vinculados permitidos

La estructura ya tiene la cantidad máxima de dispositivos permitidos.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorLa estructura ya tiene la cantidad máxima de dispositivos vinculados permitidos
typehttps://developers.nest.com/reference/error-messages#max-number-devices-error
messageLa estructura ya tiene la cantidad máxima de dispositivos vinculados permitidos

La estructura no es propiedad del usuario

La structure_id no coincide con la cuenta de usuario registrada.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorLa estructura no es propiedad del usuario.
typehttps://developers.nest.com/reference/error-messages#structure-ownership-error-uri
messageLa estructura no es propiedad del usuario.

La temperatura C es demasiado alta para la temperatura de bloqueo

El usuario bloqueó el termostato y el producto intentó establecer una temperatura final Celsius superior al rango de temperatura de bloqueo.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorLa temperatura C $tempC es demasiado alta para la temperatura de bloqueo $highLockTemp
typehttps://developers.nest.com/reference/error-messages#high-c-value-4-lock
messageLa temperatura C $tempC es demasiado alta para la temperatura de bloqueo $highLockTemp
details$tempC
$highLockTemp

La temperatura C es demasiado baja para la temperatura de bloqueo

El usuario bloqueó el termostato y el producto intentó establecer una temperatura final Celsius inferior al rango de temperatura de bloqueo.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorLa temperatura C $tempC es demasiado baja para la temperatura de bloqueo de $lowLockTemp
typehttps://developers.nest.com/reference/error-messages#low-c-value-4-lock
messageLa temperatura C $tempC es demasiado baja para la temperatura de bloqueo de $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 conocer los rangos de temperatura permitidos en Celsius, consulta target_temperature_c.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorEl valor de temperatura C es demasiado alto: $tempC
typehttps://developers.nest.com/reference/error-messages#high-c-value
messageEl 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 Celsius, consulta target_temperature_c.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorEl valor de temperatura C es demasiado bajo: $tempC
typehttps://developers.nest.com/reference/error-messages#low-c-value
messageEl valor de temperatura C es demasiado bajo: $tempC
details$tempC

La temperatura F es demasiado alta para la temperatura de bloqueo

El usuario bloqueó el termostato y el producto intentó establecer una temperatura final en Fahrenheit más alta que el rango de temperatura de bloqueo.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorLa temperatura F $tempF es demasiado alta para la temperatura de bloqueo $highLockTemp
typehttps://developers.nest.com/reference/error-messages#high-f-value-4-lock
messageLa temperatura F $tempF es demasiado alta para la temperatura de bloqueo $highLockTemp
details$tempF
$highLockTemp

La temperatura F es demasiado baja para la temperatura de bloqueo

El usuario bloqueó el termostato y el producto intentó establecer una temperatura final Fahrenheit inferior al rango de temperatura de bloqueo.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorLa temperatura F $tempF es demasiado baja para la temperatura de bloqueo $lowLockTemp
typehttps://developers.nest.com/reference/error-messages#low-f-value-4-lock
messageLa temperatura F $tempF es demasiado baja 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 final demasiado alto para una temperatura de Fahrenheit. Para conocer los rangos de temperatura permitidos en Fahrenheit, consulta target_temperature_f.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorEl valor de temperatura F es demasiado alto: $tempF
typehttps://developers.nest.com/reference/error-messages#high-f-value
messageEl 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 final demasiado bajo para una temperatura de Fahrenheit. Para conocer los rangos de temperatura permitidos en Fahrenheit, consulta target_temperature_f.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorEl valor de temperatura F es demasiado bajo: $tempF
typehttps://developers.nest.com/reference/error-messages#low-f-value
messageEl valor de temperatura F es demasiado bajo: $tempF
details$tempF

La temperatura tiene un formato incorrecto

El producto intentó establecer una temperatura final con el formato de número incorrecto para la 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 enteros (72).

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorLa temperatura $temp tiene un formato incorrecto
typehttps://developers.nest.com/reference/error-messages#format-error
messageLa temperatura $temp tiene un formato incorrecto
details$temp

No se pueden modificar los campos cuando se realizan actualizaciones

El producto intentó escribir en un campo de solo lectura.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorNo se pueden modificar los campos cuando se realice la actualización: $fieldNames
typehttps://developers.nest.com/reference/error-messages#read-only-field-error
messageNo se pueden modificar los campos cuando se realice la actualización: $fieldNames
details$fieldNames

Los campos deben usar el formato ISO 8601

El campo no tiene el formato ISO 8601.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorLos campos deben usar el formato ISO 8601: $fieldNames
typehttps://developers.nest.com/reference/error-messages#time-format-error
messageLos campos deben usar el formato ISO 8601: $fieldNames
details$fieldNames

El termostato no está en línea

El termostato no está conectado. Una vez que se habilite la conexión Wi-Fi, el producto debería volver a tener acceso.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorEl termostato no está en línea
typehttps://developers.nest.com/reference/error-messages#not-online
messageEl termostato no está en línea

Se anuló manualmente este viaje

El usuario anuló el viaje manualmente.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorSe anuló manualmente este viaje
typehttps://developers.nest.com/reference/error-messages#trip-manually-overridden
messageSe anuló manualmente este viaje

No se pudo crear el ID del lugar

Falta el objeto wheres. No se definen valores where_id.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorNo se pudo crear el ID de ubicación
typehttps://developers.nest.com/reference/error-messages#wheres-missing
messageNo se pudo crear el ID de ubicación

No autorizada

No se pudo autorizar.

Un par de condiciones pueden generar este mensaje de error:

  • redireccionamientos incorrectos que se producen cuando una implementación HTTP determinada no reenvía automáticamente el encabezado de autorización al URI redireccionado. Para obtener más información, consulta Cómo controlar los redireccionamientos.

  • permisos incorrectos cuando intentas acceder a los extremos de la API. Por ejemplo, intenta leer un extremo del termostato cuando solo se seleccionan los permisos de la cámara para el cliente. Para obtener más información, consulta Cómo elegir permisos.

Parámetros
Código de estado HTTP: 401 Unauthorized
errorNo autorizada
typehttps://developers.nest.com/reference/error-messages#auth-error
messageNo autorizada

Desconocidos

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errordesconocido
typehttps://developers.nest.com/reference/error-messages#unknown
messagedesconocido

Tipo de dispositivo o proveedor desconocido

No se reconoce el proveedor o el dispositivo durante la vinculación del dispositivo.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorTipo de dispositivo o proveedor desconocido
typehttps://developers.nest.com/reference/error-messages#unknown-vendor-device-type-error
messageTipo de dispositivo o proveedor desconocido

El valor de $fieldName es del tipo incorrecto

Se envió el tipo de datos incorrecto. Por ejemplo, enviar una string cuando se espera un valor booleano.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorEl valor de $fieldName es del tipo incorrecto
typehttps://developers.nest.com/reference/error-messages#wrong-data-type
messageEl valor de $fieldName es del tipo incorrecto
details$fieldName

Dónde existe el nombre

El where_name que el producto intentó configurar ya existe. Vuelve a intentarlo con un nombre nuevo.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorEl nombre $name ya existe
typehttps://developers.nest.com/reference/error-messages#where-name-exists
messageEl nombre $name ya existe
details$name

Dónde no se proporciona ningún nombre

Falta el where_name en la llamada.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorDónde no se proporciona ningún nombre
typehttps://developers.nest.com/reference/error-messages#where-name-missing
messageDónde no se proporciona ningún nombre

Donde el nombre es de longitud cero

La ubicación en la que name no está definido (tiene cero caracteres).

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorDonde el nombre es de longitud cero
typehttps://developers.nest.com/reference/error-messages#zero-length-where-name
messageDonde el nombre es de longitud cero

Donde el nombre debe ser una string

Se envió el tipo de datos incorrecto para where_name. Por ejemplo, un número en el que se espera una string.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorDonde el nombre debe ser una string
typehttps://developers.nest.com/reference/error-messages#where-name-wrong-format
messageDonde el nombre debe ser una string

where_id no existe

El where_id no es válido.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorwhere_id no existe
typehttps://developers.nest.com/reference/error-messages#where-id-invalid
messagewhere_id no existe
details$where_id

where_id debe ser una string

El formato where_id no es válido. Por ejemplo, se envió un número en lugar de una string.

Parámetros
Código de estado HTTP: Error 400 de solicitud incorrecta
errorwhere_id debe ser una string
typehttps://developers.nest.com/reference/error-messages#where-id-wrong-format
messagewhere_id debe ser una string

Otros mensajes y códigos de error

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, consulta lo siguiente:

Códigos de error de REST

Cuando realizas una llamada a la API de REST, se muestran códigos de estado HTTP comunes.

Mensajes de límite de frecuencia de REST

Cuando usas REST y envías demasiadas llamadas en un período corto, es posible que recibas un código de estado de respuesta HTTP 429 Demasiadas solicitudes.

Para obtener más información, consulta Límites de frecuencia de datos.