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 | |
error | Bloqueado |
type | https://developers.nest.com/reference/error-messages#blocked |
message | Bloqueado |
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 | |
error | No se puede activar el ventilador durante el corte de seguridad de humo/monóxido de carbono |
type | https://developers.nest.com/reference/error-messages#safety-shutoff-on |
message | No 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 | |
error | No se puede cambiar el estado Ausente mientras el calefactor de emergencia está encendido |
type | https://developers.nest.com/reference/error-messages#emergency-heat-is-on |
message | No se puede cambiar el estado Ausente mientras el 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 | |
error | No se puede cambiar el modo de 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 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
oeco
- Se estableció el modo de HVAC en
eco
y el producto intenta configurartarget_temperature
Parámetros | |
---|---|
Código de estado HTTP: Solicitud incorrecta 400 | |
error | No se puede cambiar el modo de HVAC a $mode ; HVAC no se puede $action . |
type | https://developers.nest.com/reference/error-messages#incompatible-mode |
message | No se puede cambiar el modo de HVAC a $mode ; HVAC no se puede $action . |
details | $mode |
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 | |
error | No se puede cambiar el modo de 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 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 | |
error | No se pueden establecer temperaturas de C y F a la vez |
type | https://developers.nest.com/reference/error-messages#multiple-value-changes |
message | No 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 | |
error | No se puede activar/desactivar fan_timer_active debido al modo incompatible $mode |
type | https://developers.nest.com/reference/error-messages#incompatible-fan-mode |
message | No se puede activar/desactivar fan_timer_active debido al modo incompatible $mode |
details | $mode |
No se puede establecer fan_timer_duration en el valor seleccionado
El producto intentó establecer fan_timer_duration
en un valor no válido. Consulta fan_timer_duration
para obtener una lista de valores válidos.
Parámetros | |
---|---|
Código de estado HTTP: Solicitud incorrecta 400 | |
error | No se puede establecer fan_timer_duration en el valor seleccionado. Consulta la referencia de la 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. 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 | |
error | No se puede establecer una temperatura final $lowTemp más alta que la temperatura final de $highTemp |
type | https://developers.nest.com/reference/error-messages#low-high-error |
message | No se puede establecer una temperatura final $lowTemp más alta que la temperatura final de $highTemp |
details | $lowTemp |
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 | |
error | No se puede establecer una temperatura final más cercana a N grados C/F |
type | https://developers.nest.com/reference/error-messages#range-error |
message | No 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 | |
error | No se puede establecer target_temperature mientras el modo está $mode |
type | https://developers.nest.com/reference/error-messages#mode-error |
message | No se puede establecer $fieldName cuando el modo es $mode |
details | $fieldName |
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 | |
error | Se 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. |
type | https://developers.nest.com/reference/error-messages#unsupported-firmware-version |
message | Se 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 | |
error | Se produjo un error al validar los campos WWN: $error |
type | https://developers.nest.com/reference/error-messages#where-id-internal |
message | Se 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 | |
error | ETA es anterior a la fecha actual: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime |
type | https://developers.nest.com/reference/error-messages#eta-in-the-past |
message | ETA es anterior a la fecha actual: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime |
details | $estimatedArrivalTime |
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 | |
error | La hora de llegada es demasiado lejana |
type | https://developers.nest.com/reference/error-messages#eta-too-far-in-the-future |
message | La 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 | |
error | No se estableció el temporizador para ventilador |
type | https://developers.nest.com/reference/error-messages#fan-timer-active-value-missing |
message | No 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 | |
error | Prohibido |
type | https://developers.nest.com/reference/error-messages#forbidden |
message | Prohibido |
Error interno
Parámetros | |
---|---|
Código de estado HTTP: Error interno del servidor 500 | |
error | Error interno |
type | https://developers.nest.com/reference/error-messages#internal-error |
message | Error 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 | |
error | ID de cámara $id no válido |
type | https://developers.nest.com/reference/error-messages#invalid-camera-id |
message | ID 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 | |
error | Se envió contenido no válido |
type | https://developers.nest.com/reference/error-messages#invalid-content-sent |
message | Se envió contenido no válido |
Ruta de fragmento no válida
Parte de la ruta de la solicitud no es válida. Por ejemplo, un nombre de objeto o campo puede estar mal escrito.
Parámetros | |
---|---|
Código de estado HTTP: Solicitud incorrecta 400 | |
error | Ruta de fragmento no válida: $requestPath |
type | https://developers.nest.com/reference/error-messages#invalid-fragment |
message | Ruta 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 | |
error | Modo de HVAC no válido: $mode |
type | https://developers.nest.com/reference/error-messages#invalid-mode |
message | Modo 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 | |
error | El ID de la alarma de humo+co $id no es válido. |
type | https://developers.nest.com/reference/error-messages#invalid-smoke-co-alarm-id |
message | ID de alarma de humo+co no válido: $id |
details | $id |
ID de estructura no válido
El structure_id
no es válido.
Parámetros | |
---|---|
Código de estado HTTP: Solicitud incorrecta 400 | |
error | ID de estructura $id no válido |
type | https://developers.nest.com/reference/error-messages#invalid-structure-id |
message | ID de estructura no válido: $id |
details | $id |
ID de termostato no válido
El thermostat_id
no es válido.
Parámetros | |
---|---|
Código de estado HTTP: Solicitud incorrecta 400 | |
error | El ID de termostato $id no es válido |
type | https://developers.nest.com/reference/error-messages#invalid-thermostat-id |
message | ID de termostato no válido: $id |
details | $id |
Valor no válido para Ausente
Intentaste establecer un valor no válido para away
.
Parámetros | |
---|---|
Código de estado HTTP: Solicitud incorrecta 400 | |
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 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 | |
error | is_streaming no es booleano |
type | https://developers.nest.com/reference/error-messages#invalid-is-stream-format |
message | is_streaming no es booleano |
La etiqueta debe tener menos de 256 caracteres
El producto intentó crear una etiqueta de termostato con más de 256 caracteres.
Parámetros | |
---|---|
Código de estado HTTP: Solicitud incorrecta 400 | |
error | La etiqueta debe tener menos de $max_label_length caracteres |
type | https://developers.nest.com/reference/error-messages#max-label-length |
message | La etiqueta debe tener menos de $max_label_length caracteres |
details | $max_label_length |
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 | |
error | Máx. personalizado donde se superó el recuento de $max_where_count |
type | https://developers.nest.com/reference/error-messages#max-where-count |
message | Má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 | |
error | Se excedió el límite de personalización de $max_custom_where_name_length |
type | https://developers.nest.com/reference/error-messages#max-where-name-length |
message | Se 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 | |
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 la ubicación
Falta el formato where_id
.
Parámetros | |
---|---|
Código de estado HTTP: Solicitud incorrecta 400 | |
error | Falta el ID del lugar |
type | https://developers.nest.com/reference/error-messages#where-id-missing |
message | Falta 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 | |
error | No tiene ventilador de HVAC |
type | https://developers.nest.com/reference/error-messages#no-hvac-fan |
message | No 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 | |
error | No hay termostatos en línea |
type | https://developers.nest.com/reference/error-messages#no-thermostats-online |
message | No hay termostatos en línea |
No hay dispositivos 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 | |
error | No hay dispositivos sincronizados |
type | https://developers.nest.com/reference/error-messages#no-paired-devices |
message | No 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 | |
error | No hay hora de llegada válida para cancelar |
type | https://developers.nest.com/reference/error-messages#no-valid-eta-to-cancel |
message | No 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 | |
error | No hay permisos de escritura para los campos: $fields |
type | https://developers.nest.com/reference/error-messages#no-write-permission |
message | No 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 | |
error | El tipo de solicitud no es válido: $requestType |
type | https://developers.nest.com/reference/error-messages#request-type-not-allowed |
message | El 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 | |
error | No encontrado |
type | https://developers.nest.com/reference/error-messages#not-found |
message | No 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 | |
error | No está en modo Ausente |
type | https://developers.nest.com/reference/error-messages#not-in-away-mode |
message | No 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 | |
error | No admite escritura |
type | https://developers.nest.com/reference/error-messages#not-writable |
message | No 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 | |
error | Solo donde se debe proporcionar el nombre |
type | https://developers.nest.com/reference/error-messages#extra-fields |
message | Solo donde se debe proporcionar el nombre |
POST no es un tipo de solicitud válido
El tipo de solicitud no es válido. Por ejemplo, se realizó una llamada POST cuando se requiere una PUT.
Parámetros | |
---|---|
Código de estado HTTP: Solicitud incorrecta 400 | |
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 |
Incumplimiento del esquema
Se produjo un error al vincular los dispositivos.
Parámetros | |
---|---|
Código de estado HTTP: Solicitud incorrecta 400 | |
error | Incumplimiento del esquema |
type | https://developers.nest.com/reference/error-messages#schema-violation-error |
message | Incumplimiento del esquema |
Servicio no disponible
Parámetros | |
---|---|
Código de estado HTTP: Servicio 503 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 vinculados permitidos
La estructura ya tiene la cantidad máxima de dispositivos permitidos.
Parámetros | |
---|---|
Código de estado HTTP: Solicitud incorrecta 400 | |
error | La estructura ya tiene la cantidad máxima de dispositivos vinculados permitidos |
type | https://developers.nest.com/reference/error-messages#max-number-devices-error |
message | La 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 | |
error | La estructura no es propiedad del usuario. |
type | https://developers.nest.com/reference/error-messages#structure-ownership-error-uri |
message | La estructura no es propiedad del usuario. |
La temperatura C es demasiado alta para la temperatura de bloqueo
El usuario 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 | |
error | La temperatura C $tempC es demasiado alta para la temperatura de bloqueo $highLockTemp |
type | https://developers.nest.com/reference/error-messages#high-c-value-4-lock |
message | La temperatura C $tempC es demasiado alta para la temperatura de bloqueo $highLockTemp |
details | $tempC |
La temperatura C es demasiado baja para la temperatura de bloqueo
El usuario 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 | |
error | La temperatura C $tempC es demasiado baja para la temperatura de bloqueo $lowLockTemp |
type | https://developers.nest.com/reference/error-messages#low-c-value-4-lock |
message | La temperatura C $tempC es demasiado baja para la temperatura de bloqueo $lowLockTemp |
details | $tempC |
El valor de 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 | |
error | El valor de temperatura C es demasiado alto: $tempC |
type | https://developers.nest.com/reference/error-messages#high-c-value |
message | El valor de temperatura C es demasiado alto: $tempC |
details | $tempC |
El valor de temperatura C es demasiado bajo
El producto intentó establecer un valor de temperatura 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 | |
error | El valor de temperatura C es demasiado bajo: $tempC |
type | https://developers.nest.com/reference/error-messages#low-c-value |
message | El valor de temperatura C es demasiado bajo: $tempC |
details | $tempC |
La temperatura F es demasiado alta para la temperatura de 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 | |
error | La temperatura F $tempF es demasiado alta para la temperatura de bloqueo $highLockTemp |
type | https://developers.nest.com/reference/error-messages#high-f-value-4-lock |
message | La temperatura F $tempF es demasiado alta para la temperatura de bloqueo $highLockTemp |
details | $tempF |
La temperatura F es demasiado baja para 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 | |
error | La temperatura F $tempF es demasiado baja para la temperatura de bloqueo $lowLockTemp |
type | https://developers.nest.com/reference/error-messages#low-f-value-4-lock |
message | La temperatura F $tempF es demasiado baja para la temperatura de bloqueo $lowLockTemp |
details | $tempF |
El valor de la temperatura F es demasiado alto
El producto intentó establecer un valor de temperatura 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 | |
error | El valor de temperatura F es demasiado alto: $tempF |
type | https://developers.nest.com/reference/error-messages#high-f-value |
message | El valor de temperatura F es demasiado alto: $tempF |
details | $tempF |
El valor de 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 | |
error | El valor de la temperatura F es demasiado bajo: $tempF |
type | https://developers.nest.com/reference/error-messages#low-f-value |
message | El valor de la temperatura F es demasiado bajo: $tempF |
details | $tempF |
La temperatura 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 | |
error | La temperatura $temp tiene un formato incorrecto |
type | https://developers.nest.com/reference/error-messages#format-error |
message | La 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 | |
error | No se pueden modificar los campos en la actualización: $fieldNames |
type | https://developers.nest.com/reference/error-messages#read-only-field-error |
message | No 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 | |
error | Los campos deben usar el formato ISO 8601: $fieldNames |
type | https://developers.nest.com/reference/error-messages#time-format-error |
message | Los campos deben usar el formato ISO 8601: $fieldNames |
details | $fieldNames |
El termostato no está en línea
El termostato 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 | |
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 |
Se anuló manualmente este viaje
El usuario anuló manualmente el viaje.
Parámetros | |
---|---|
Código de estado HTTP: Solicitud incorrecta 400 | |
error | Se anuló manualmente este viaje |
type | https://developers.nest.com/reference/error-messages#trip-manually-overidden |
message | Se 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 | |
error | No se pudo crear el ID del lugar |
type | https://developers.nest.com/reference/error-messages#wheres-missing |
message | No 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 | |
error | Sin autorización |
type | https://developers.nest.com/reference/error-messages#auth-error |
message | Sin autorización |
Desconocido
Parámetros | |
---|---|
Código de estado HTTP: Solicitud incorrecta 400 | |
error | desconocido |
type | https://developers.nest.com/reference/error-messages#unknown |
message | desconocido |
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 | |
error | Tipo de proveedor o dispositivo desconocido |
type | https://developers.nest.com/reference/error-messages#unknown-vendor-device-type-error |
message | Tipo 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 | |
error | El valor de $fieldName es del tipo incorrecto |
type | https://developers.nest.com/reference/error-messages#wrong-data-type |
message | El 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 | |
error | Donde ya existe el nombre $name |
type | https://developers.nest.com/reference/error-messages#where-name-exists |
message | Donde 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 | |
error | No se proporcionó el nombre |
type | https://developers.nest.com/reference/error-messages#where-name-missing |
message | No 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 | |
error | El nombre tiene una longitud de cero |
type | https://developers.nest.com/reference/error-messages#zero-length-where-name |
message | El 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 | |
error | Donde el nombre debe ser una string |
type | https://developers.nest.com/reference/error-messages#where-name-wrong-format |
message | Donde 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 | |
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 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 | |
error | Where_id debe ser una string |
type | https://developers.nest.com/reference/error-messages#where-id-wrong-format |
message | Where_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.