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 ir desde fallas simples, como un parámetro faltante o no válido, hasta situaciones más complejas, como un estado inesperado o incluso una configuración relacionada 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 error, type, message y instance. El objeto details es opcional.

Campo Descripción
error Formato de mensaje de error corto.
type Proporciona una URL a la información detallada sobre la condición del error (esta página).
message Formato de mensaje de error largo que puede usar variables para proporcionar detalles adicionales. Cuando se incluya una variable en el mensaje, aparecerá en el objeto details.
instance Una string de texto que contiene un identificador de error ú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 información sobre los errores no relacionados con la API de Nest, consulta Otros códigos y mensajes de error.

Bloqueado

Se superó 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 de humo/monóxido de carbono

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

Parámetros
Código de estado HTTP: Solicitud incorrecta 400
errorNo se puede activar el ventilador durante el corte de seguridad de humo/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 de humo/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 función Calefactor de emergencia estaba encendida.

Parámetros
Código de estado HTTP: Solicitud incorrecta 400
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 de HVAC durante eventos de ahorro de energía

Un evento de ahorro de energía definido por un socio de energía 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: Solicitud incorrecta 400
errorNo se puede cambiar el modo de HVAC durante eventos de ahorro de energía
typehttps://developers.nest.com/reference/error-messages#energy-saving-event-on
messageNo se puede cambiar el modo de HVAC durante eventos de ahorro de energía

No se puede cambiar el modo de HVAC

El modo no es compatible con la solicitud.

Por ejemplo, es posible que recibas este mensaje en los siguientes casos:

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

No se puede cambiar el modo de 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: Solicitud incorrecta 400
errorNo se puede cambiar el modo de HVAC mientras el bloqueo del termostato está habilitado
typehttps://developers.nest.com/reference/error-messages#lock-enabled
messageNo se puede cambiar el modo de HVAC mientras el bloqueo del termostato está habilitado

No se pueden establecer temperaturas de C y F a la vez

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

Parámetros
Código de estado HTTP: Solicitud incorrecta 400
errorNo se pueden establecer temperaturas de C y F a la vez
typehttps://developers.nest.com/reference/error-messages#multiple-value-changes
messageNo se pueden establecer temperaturas de C y F a la vez

No se puede activar/desactivar ventilador_timer_active debido a un modo incompatible

El ventilador del sistema de HVAC ya está en funcionamiento (ya sea de forma manual, por un usuario, en 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 podemos anular a través de la API.

Parámetros
Código de estado HTTP: Solicitud incorrecta 400
errorNo se puede activar/desactivar fan_timer_active debido al modo incompatible $mode
typehttps://developers.nest.com/reference/error-messages#incompatible-fan-mode
messageNo 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. Consulta fan_timer_duration para obtener una lista de valores válidos.

Parámetros
Código de estado HTTP: Solicitud incorrecta 400
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ás alta que la temperatura final

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

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

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

El producto intentó establecer un valor de temperatura final demasiado cercano a la temperatura final máxima o mínima objetivo (por ejemplo, target_temperature_high_f).

Parámetros
Código de estado HTTP: Solicitud incorrecta 400
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 inferior a $min grados $scale
details$min
$scale

No se puede establecer target_temperature mientras el modo sea $mode

El termostato o la estructura se encuentran actualmente 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 es off o en modo heat-cool. El valor no se puede cambiar hasta que el termostato o la estructura regresen a un modo no restringido.

En este mensaje, $fieldName puede ser cualquiera de los valores de temperatura objetivo 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: Solicitud incorrecta 400
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 cuando el modo es $mode
details$fieldName
$mode

Se requiere la actualización del firmware del dispositivo para que puedas cambiar el modo de HVAC

Se debe actualizar el dispositivo a la versión de firmware actual para establecer Temperaturas Eco.

Parámetros
Código de estado HTTP: Solicitud incorrecta 400
errorSe requiere la actualización del firmware del dispositivo para que puedas cambiar el modo de HVAC. Las actualizaciones son automáticas y se realizan automáticamente una semana después del lanzamiento.
typehttps://developers.nest.com/reference/error-messages#unsupported-firmware-version
messageSe requiere la actualización del firmware del dispositivo para que puedas cambiar el modo de HVAC. Las actualizaciones son automáticas y se realizan automáticamente una semana después del lanzamiento.

Se produjo un error al validar los campos WWN

Parámetros
Código de estado HTTP: Solicitud incorrecta 400
errorSe produjo un error al validar los campos WWN: $error
typehttps://developers.nest.com/reference/error-messages#where-id-internal
messageSe produjo un error al validar los campos WWN: $error
details$error

ETA es anterior a la fecha actual

La hora de llegada estimada es anterior a la actual (antes de YA). Para obtener más información sobre cómo hacer llamadas de ETA, consulta la Guía de ETA y Ausente.

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

La hora de llegada es demasiado lejana

La hora de llegada estimada no puede ser superior a 8 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: Solicitud incorrecta 400
errorLa hora de llegada es demasiado lejana
typehttps://developers.nest.com/reference/error-messages#eta-too-far-in-the-future
messageLa hora de llegada es demasiado lejana

No se estableció el temporizador para ventilador

No se definió fan_timer_active.

Parámetros
Código de estado HTTP: Solicitud incorrecta 400
errorNo se estableció el temporizador para ventilador
typehttps://developers.nest.com/reference/error-messages#fan-timer-active-value-missing
messageNo se estableció el temporizador para ventilador

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: Solicitud incorrecta 400
errorID de cámara $id no válido
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: Solicitud incorrecta 400
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, un nombre de objeto o campo puede estar mal escrito.

Parámetros
Código de estado HTTP: Solicitud incorrecta 400
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: Solicitud incorrecta 400
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álida

El smoke_co_alarm_id no es válido.

Parámetros
Código de estado HTTP: Solicitud incorrecta 400
errorEl ID de la alarma de humo+co $id no es válido.
typehttps://developers.nest.com/reference/error-messages#invalid-smoke-co-alarm-id
messageID de alarma de humo+co no 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: Solicitud incorrecta 400
errorID de estructura $id no válido
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: Solicitud incorrecta 400
errorEl ID de termostato $id no es válido
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: Solicitud incorrecta 400
errorValor no válido para Ausente
typehttps://developers.nest.com/reference/error-messages#invalid-away-value
messageValor no válido: $value. Solo los valores permitidos son los de “Casa” y “No disponible”.
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: Solicitud incorrecta 400
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: Solicitud incorrecta 400
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 máxima de casos en los que se superó la cantidad personalizada

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

Parámetros
Código de estado HTTP: Solicitud incorrecta 400
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

Máx. personalizado donde se excedió la longitud del nombre

El campo name es demasiado largo. Recomendamos que utilice menos de 30 caracteres.

Parámetros
Código de estado HTTP: Solicitud incorrecta 400
errorSe excedió el límite de personalización de $max_custom_where_name_length
typehttps://developers.nest.com/reference/error-messages#max-where-name-length
messageSe excedió el límite de personalización de $max_custom_where_name_length
details$max_custom_where_name_length

Falta un campo

La llamada no tiene un parámetro obligatorio.

Parámetros
Código de estado HTTP: Solicitud incorrecta 400
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: Solicitud incorrecta 400
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

Al parecer, el sistema de HVAC no tiene un ventilador independiente.

Parámetros
Código de estado HTTP: Solicitud incorrecta 400
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 tiene conexión. Después de habilitar el Wi-Fi, tu producto debería volver a tener acceso.

Parámetros
Código de estado HTTP: Solicitud incorrecta 400
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 la cuenta de Nest

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

No hay hora de llegada válida para cancelar

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

Parámetros
Código de estado HTTP: Solicitud incorrecta 400
errorNo hay hora de llegada válida para cancelar
typehttps://developers.nest.com/reference/error-messages#no-valid-eta-to-cancel
messageNo hay hora de llegada válida 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: Solicitud incorrecta 400
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: Solicitud incorrecta 400
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á en modo Ausente.

Parámetros
Código de estado HTTP: Solicitud incorrecta 400
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: Solicitud incorrecta 400
errorNo admite escritura
typehttps://developers.nest.com/reference/error-messages#not-writable
messageNo admite escritura

Solo donde se debe proporcionar el nombre

Se incluyeron campos adicionales en la llamada wheres.

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

Parámetros
Código de estado HTTP: Solicitud incorrecta 400
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 vincular los dispositivos.

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

Servicio no 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: Solicitud incorrecta 400
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

El structure_id no coincide con la cuenta de usuario registrada.

Parámetros
Código de estado HTTP: Solicitud incorrecta 400
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 en Celsius más alta que el rango de temperatura de bloqueo.

Parámetros
Código de estado HTTP: Solicitud incorrecta 400
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 menor que el rango de temperatura de bloqueo.

Parámetros
Código de estado HTTP: Solicitud incorrecta 400
errorLa temperatura C $tempC es demasiado baja para la temperatura de bloqueo $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 $lowLockTemp
details$tempC
$lowLockTemp

El valor de temperatura C es demasiado alto

El producto intentó establecer un valor de temperatura final demasiado alto para una temperatura Celsius. Para conocer los rangos de temperatura permitidos en grados Celsius, consulta target_temperature_c.

Parámetros
Código de estado HTTP: Solicitud incorrecta 400
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 final demasiado bajo para una temperatura Celsius. Para conocer los rangos de temperatura permitidos en grados Celsius, consulta target_temperature_c.

Parámetros
Código de estado HTTP: Solicitud incorrecta 400
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: Solicitud incorrecta 400
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 establecer la temperatura de bloqueo

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

Parámetros
Código de estado HTTP: Solicitud incorrecta 400
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 la temperatura F es demasiado alto

El producto intentó establecer un valor de temperatura final demasiado alto para una temperatura de Farenrenit. Para conocer los rangos de temperatura permitidos en Fahrenheit, consulta target_temperature_f.

Parámetros
Código de estado HTTP: Solicitud incorrecta 400
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 la temperatura F es demasiado bajo

El producto intentó establecer un valor de temperatura final demasiado bajo para una temperatura de Farenrenit. Para conocer los rangos de temperatura permitidos en Fahrenheit, consulta target_temperature_f.

Parámetros
Código de estado HTTP: Solicitud incorrecta 400
errorEl valor de la temperatura F es demasiado bajo: $tempF
typehttps://developers.nest.com/reference/error-messages#low-f-value
messageEl valor de la 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 el temperature_scale elegido. Las temperaturas de Celsius deben ser números enteros en incrementos de 0.5 grados (21.5), y las temperaturas en Fahrenheit deben ser números enteros enteros (72).

Parámetros
Código de estado HTTP: Solicitud incorrecta 400
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 en la actualización

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

Parámetros
Código de estado HTTP: Solicitud incorrecta 400
errorNo se pueden modificar los campos en la actualización: $fieldNames
typehttps://developers.nest.com/reference/error-messages#read-only-field-error
messageNo se pueden modificar los campos en 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: Solicitud incorrecta 400
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 tiene conexión. Después de habilitar el Wi-Fi, tu producto debería volver a tener acceso.

Parámetros
Código de estado HTTP: Solicitud incorrecta 400
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ó manualmente el viaje.

Parámetros
Código de estado HTTP: Solicitud incorrecta 400
errorSe anuló manualmente este viaje
typehttps://developers.nest.com/reference/error-messages#trip-manually-overidden
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: Solicitud incorrecta 400
errorNo se pudo crear el ID del lugar
typehttps://developers.nest.com/reference/error-messages#wheres-missing
messageNo se pudo crear el ID del lugar

Sin autorización

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 se intenta acceder a los extremos de la API. Por ejemplo, cuando se leen los extremos del termostato cuando solo se seleccionan los permisos de cámara para el cliente. Para obtener más información, consulta Cómo elegir los permisos.

Parámetros
Código de estado HTTP: 401 No autorizado
errorSin autorización
typehttps://developers.nest.com/reference/error-messages#auth-error
messageSin autorización

Desconocido

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

Tipo de proveedor o dispositivo desconocido

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

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

El valor de $fieldName es de 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: Solicitud incorrecta 400
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ó establecer ya existe. Vuelve a intentarlo con otro nombre.

Parámetros
Código de estado HTTP: Solicitud incorrecta 400
errorDonde ya existe el nombre $name
typehttps://developers.nest.com/reference/error-messages#where-name-exists
messageDonde ya existe el nombre $name
details$name

No se proporcionó el nombre

Falta el where_name en la llamada.

Parámetros
Código de estado HTTP: Solicitud incorrecta 400
errorNo se proporcionó el nombre
typehttps://developers.nest.com/reference/error-messages#where-name-missing
messageNo se proporcionó el nombre

El nombre tiene una longitud de cero

Cuando name no está definido (tiene cero caracteres).

Parámetros
Código de estado HTTP: Solicitud incorrecta 400
errorEl nombre tiene una longitud de cero
typehttps://developers.nest.com/reference/error-messages#zero-length-where-name
messageEl nombre tiene una longitud de cero

Donde el nombre debe ser una string

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

Parámetros
Código de estado HTTP: Solicitud incorrecta 400
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: Solicitud incorrecta 400
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: Solicitud incorrecta 400
errorWhere_id debe ser una string
typehttps://developers.nest.com/reference/error-messages#where-id-wrong-format
messageWhere_id debe ser una string

Otros códigos y mensajes de error

Códigos de error del dispositivo

Para obtener códigos de mensajes específicos del dispositivo y 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 sobre el 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.

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