Ошибочные состояния являются частью цикла разработки и могут варьироваться от простых ошибок, таких как недопустимый или отсутствующий параметр, до более сложных сценариев, таких как непредвиденное состояние или даже настройки, связанные с устройством, которые необходимо разрешать вне API.
При возникновении ошибки во время вызова API отправляется ответ в таком формате:
{ "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" } }
Все сообщения об ошибках содержат поля error
, type
, message
и instance
. Объект details
является необязательным.
Поле | Описание |
---|---|
error | Короткий формат сообщения об ошибке. |
type | Предоставляет URL-адрес для подробной информации об ошибке (эта страница). |
message | Формат длинного сообщения об ошибке, в котором могут использоваться переменные для предоставления дополнительных сведений. Когда переменная включена в сообщение, она появится в объекте details . |
instance | Текстовая строка, содержащая идентификатор ошибки, уникальный для каждого отдельного вызова. Мы можем запросить у вас номер экземпляра, если вы сообщите о проблеме со службой. |
details | Необязательный. Содержит переменные, которые вставляются в message . Сообщения могут содержать несколько переменных. |
Информацию об ошибках, не связанных с Nest API, см. в разделе Другие коды ошибок и сообщения .
Заблокировано
Лимит скорости превышен.
Параметры | |
---|---|
Код состояния HTTP: 429 Слишком много запросов | |
error | Заблокировано |
type | https://developers.nest.com/reference/error-messages#blocked |
message | Заблокировано |
Невозможно активировать вентилятор во время отключения дыма / угарного газа
Аварийное отключение действует. Вызовы API не принимаются до тех пор, пока не будет восстановлена нормальная работа.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Невозможно активировать вентилятор во время отключения дыма / угарного газа |
type | https://developers.nest.com/reference/error-messages#safety-shutoff-on |
message | Невозможно активировать вентилятор во время отключения дыма / угарного газа |
Невозможно изменить состояние «Нет на месте», пока включено аварийное отопление
Устройство пыталось изменить состояние «Нет на месте» при включенном аварийном нагреве .
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Невозможно изменить состояние «Нет на месте», пока включено аварийное отопление |
type | https://developers.nest.com/reference/error-messages#emergency-heat-is-on |
message | Невозможно изменить состояние «Нет на месте», пока включено аварийное отопление |
Невозможно изменить режим HVAC во время энергосберегающих мероприятий
Действует энергосберегающее мероприятие , определенное энергетическим партнером Nest. Вызовы API отклоняются до окончания события энергосбережения.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Невозможно изменить режим HVAC во время энергосберегающих мероприятий |
type | https://developers.nest.com/reference/error-messages#energy-saving-event-on |
message | Невозможно изменить режим HVAC во время энергосберегающих мероприятий |
Невозможно изменить режим HVAC
Режим несовместим с запросом.
Например, вы можете получить это сообщение, если:
- Система HVAC термостата не поддерживает режим, запрошенный вашим продуктом:
heat
,cool
,heat-cool
илиeco
. - Режим HVAC установлен на
eco
, и продукт пытается установитьtarget_temperature
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Невозможно изменить режим HVAC на $mode ; HVAC не может $action |
type | https://developers.nest.com/reference/error-messages#incompatible-mode |
message | Невозможно изменить режим HVAC на $mode ; HVAC не может $action |
details | $mode |
Невозможно изменить режим HVAC, пока включена блокировка термостата
Пользователь должен разблокировать термостат , прежде чем продукт сможет записывать данные.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Невозможно изменить режим HVAC, пока включена блокировка термостата |
type | https://developers.nest.com/reference/error-messages#lock-enabled |
message | Невозможно изменить режим HVAC, пока включена блокировка термостата |
Невозможно установить температуры C и F одновременно
Продукт пытался одновременно установить целевые температуры в градусах Цельсия и Фаренгейта. Продукт должен устанавливать только целевую температуру, указанную в temperature_scale
(C/F).
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Невозможно установить температуры C и F одновременно |
type | https://developers.nest.com/reference/error-messages#multiple-value-changes |
message | Невозможно установить температуры C и F одновременно |
Невозможно включить/выключить fan_timer_active из-за несовместимого режима
Вентилятор системы ОВКВ уже включен (либо вручную пользователем, либо по расписанию, либо из-за цикла обогрева/охлаждения ОВКВ).
Если вы не получите ожидаемого результата, это, скорее всего, связано с тем, что устройство имеет встроенное поведение, которое мы не можем переопределить через API.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Невозможно включить/выключить fan_timer_active из-за несовместимого режима $mode |
type | https://developers.nest.com/reference/error-messages#incompatible-fan-mode |
message | Невозможно включить/выключить fan_timer_active из-за несовместимого режима $mode |
details | $mode |
Невозможно установить для fan_timer_duration выбранное значение
Продукт попытался установить для fan_timer_duration
недопустимое значение. Смотрите fan_timer_duration
для списка допустимых значений.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Невозможно установить для fan_timer_duration выбранное значение. См. справочник по API для допустимых значений. |
type | https://developers.nest.com/reference/error-messages#invalid-fan-timer-duration |
message | Невозможно установить для fan_timer_duration выбранное значение. См. справочник по API для допустимых значений. |
Невозможно установить целевую низкую температуру выше целевой высокой температуры
Термостат находится в режиме heat-cool
, и устройство попыталось установить целевую температуру ниже/высокой, которая находится за пределами допустимого диапазона. Например, продукт попытался установить target_temperature_low_c
25 °C, когда target_temperature_high_c
равно 24 °C.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Невозможно установить целевую низкую температуру $lowTemp выше целевой высокой температуры $highTemp |
type | https://developers.nest.com/reference/error-messages#low-high-error |
message | Невозможно установить целевую низкую температуру $lowTemp выше целевой высокой температуры $highTemp |
details | $lowTemp |
Невозможно установить целевую температуру ближе, чем N градусов C/F.
Продукт попытался установить целевое значение температуры слишком близко к целевому высокому/низкому значению температуры (например, target_temperature_high_f
).
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Невозможно установить целевую температуру ближе, чем N градусов C/F. |
type | https://developers.nest.com/reference/error-messages#range-error |
message | Невозможно установить целевую температуру ближе, чем $min градусов $scale |
details | $min $scale |
Невозможно установить целевую_температуру, пока режим равен $mode.
Термостат или конструкция в настоящее время находятся в режиме, который не поддерживает запросы API.
Например, вы не можете установить target_temperature_f
или target_temperature_c
когда система HVAC off
или находится в режиме heat-cool
. Значение не может быть изменено до тех пор, пока термостат/конструкция не переключится обратно в неограниченный режим.
В этом сообщении $fieldName
может быть любым значением целевой температуры, а $mode
может быть любым из: eco
, emer_heat_enable
, heat-cool
, heat
, cool
, off
, hvac_safety_shutoff_active
.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Невозможно установить целевую_температуру, пока режим равен $mode |
type | https://developers.nest.com/reference/error-messages#mode-error |
message | Невозможно установить $fieldName , пока режим равен $mode |
details | $fieldName |
Перед изменением режима HVAC требуется обновление микропрограммы устройства.
Устройство должно быть обновлено до текущей версии прошивки, чтобы установить экотемпературу.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Перед изменением режима HVAC требуется обновление микропрограммы устройства. Обновления автоматические, как правило, в течение недели после выпуска. |
type | https://developers.nest.com/reference/error-messages#unsupported-firmware-version |
message | Перед изменением режима HVAC требуется обновление микропрограммы устройства. Обновления автоматические, как правило, в течение недели после выпуска. |
Ошибка при проверке полей WWN
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Ошибка при проверке полей WWN: $error |
type | https://developers.nest.com/reference/error-messages#where-id-internal |
message | Ошибка при проверке полей WWN: $error |
details | $error |
ЭТА в прошлом
Указанное время ETA находится в прошлом (до СЕЙЧАС). Дополнительную информацию о вызовах ETA см. в Руководстве по отсутствию и ETA .
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Расчетное время прибытия в прошлом: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime |
type | https://developers.nest.com/reference/error-messages#eta-in-the-past |
message | Расчетное время прибытия в прошлом: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime |
details | $estimatedArrivalTime |
ETA слишком далеко в будущем
Указанное время ETA не может превышать 8 часов в будущем. Дополнительную информацию о вызовах ETA см. в Руководстве по отсутствию и ETA .
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | ETA слишком далеко в будущем |
type | https://developers.nest.com/reference/error-messages#eta-too-far-in-the-future |
message | ETA слишком далеко в будущем |
fan_timer_active не установлен
fan_timer_active
не определен.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | fan_timer_active не установлен |
type | https://developers.nest.com/reference/error-messages#fan-timer-active-value-missing |
message | fan_timer_active не установлен |
Запрещенный
Учетные данные, используемые для доступа к службе Nest, недействительны.
Параметры | |
---|---|
Код состояния HTTP: 403 Запрещено | |
error | Запрещенный |
type | https://developers.nest.com/reference/error-messages#forbidden |
message | Запрещенный |
Внутренняя ошибка
Параметры | |
---|---|
Код состояния HTTP: 500 Внутренняя ошибка сервера | |
error | Внутренняя ошибка |
type | https://developers.nest.com/reference/error-messages#internal-error |
message | Внутренняя ошибка |
Неверный идентификатор камеры
Идентификатор camera-id
недействителен.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Недопустимый идентификатор камеры $id |
type | https://developers.nest.com/reference/error-messages#invalid-camera-id |
message | Неверный идентификатор камеры: $id |
details | $id |
Недействительный контент отправлен
Вызов содержит недопустимый контент. Например, используя «да» вместо «истина» для логической переменной.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Недействительный контент отправлен |
type | https://developers.nest.com/reference/error-messages#invalid-content-sent |
message | Недействительный контент отправлен |
Неверный путь к фрагменту
Часть пути запроса недействительна. Например, имя объекта или поля может быть написано с ошибкой.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Неверный путь фрагмента: $requestPath |
type | https://developers.nest.com/reference/error-messages#invalid-fragment |
message | Неверный путь фрагмента: $requestPath |
details | $requestPath |
Неверный режим HVAC
Система HVAC термостата не поддерживает режим, запрошенный продуктом: heat
, cool
или heat-cool
.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Неверный режим HVAC: $mode |
type | https://developers.nest.com/reference/error-messages#invalid-mode |
message | Неверный режим HVAC: $mode |
details | $mode |
Неверный идентификатор датчика дыма и угарного газа
smoke_co_alarm_id
.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Неверный идентификатор дымовой и угарной сигнализации $id |
type | https://developers.nest.com/reference/error-messages#invalid-smoke-co-alarm-id |
message | Недействительный идентификатор датчика дыма и угарного газа: $id |
details | $id |
Недопустимый идентификатор структуры
structure_id
недействителен.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Недопустимый идентификатор структуры $id |
type | https://developers.nest.com/reference/error-messages#invalid-structure-id |
message | Недопустимый идентификатор структуры: $id |
details | $id |
Неверный идентификатор термостата
thermostat_id
недействителен.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Неверный идентификатор термостата $id |
type | https://developers.nest.com/reference/error-messages#invalid-thermostat-id |
message | Неверный идентификатор термостата: $id |
details | $id |
Неверное значение для Нет дома
Вы пытались установить недопустимое значение для away
.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Неверное значение для Нет дома |
type | https://developers.nest.com/reference/error-messages#invalid-away-value |
message | Неверное значение: $value . Допустимыми значениями являются только «дома» и «в гостях». |
details | $value |
is_streaming не является логическим значением
Продукт попытался установить для поля is-streaming
значение, не являющееся логическим.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | is_streaming не является логическим значением |
type | https://developers.nest.com/reference/error-messages#invalid-is-stream-format |
message | is_streaming не является логическим значением |
Ярлык должен содержать менее 256 символов.
Продукт попытался создать этикетку термостата, содержащую более 256 символов.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Метка должна содержать менее $max_label_length символов. |
type | https://developers.nest.com/reference/error-messages#max-label-length |
message | Метка должна содержать менее $max_label_length символов. |
details | $max_label_length |
Макс. пользовательский, где превышено количество
Продукт попытался создать пользовательский объект wheres
сверх максимального количества. Максимально допустимое количество настраиваемых объектов wheres
— 32.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Макс. пользовательское значение, при котором превышено количество $max_where_count |
type | https://developers.nest.com/reference/error-messages#max-where-count |
message | Макс. пользовательское значение, при котором превышено количество $max_where_count |
details | $max_where_count |
Max custom, где длина имени превышена
Слишком длинное name
. Мы рекомендуем менее 30 символов.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Max custom, где длина имени $max_custom_where_name_length превышена |
type | https://developers.nest.com/reference/error-messages#max-where-name-length |
message | Max custom, где длина имени $max_custom_where_name_length превышена |
details | $max_custom_where_name_length |
Отсутствует поле
В вызове отсутствует обязательный параметр.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Отсутствует поле: $fieldName |
type | https://developers.nest.com/reference/error-messages#field-is-missing |
message | Отсутствует поле: $fieldName |
details | $fieldName |
Отсутствует где ID
Отсутствует формат where_id
.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Отсутствует идентификатор |
type | https://developers.nest.com/reference/error-messages#where-id-missing |
message | Отсутствует идентификатор |
Нет вентилятора ОВКВ
В системе HVAC нет отдельного вентилятора.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Нет вентилятора ОВК |
type | https://developers.nest.com/reference/error-messages#no-hvac-fan |
message | Нет вентилятора ОВК |
Нет онлайн-термостатов
В настоящее время термостат отключен. После включения Wi-Fi ваш продукт должен восстановить доступ.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Нет онлайн-термостатов |
type | https://developers.nest.com/reference/error-messages#no-thermostats-online |
message | Нет онлайн-термостатов |
Нет сопряженных устройств
Устройства Nest пользователя не связаны с его учетной записью Nest .
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Нет сопряженных устройств |
type | https://developers.nest.com/reference/error-messages#no-paired-devices |
message | Нет сопряженных устройств |
Нет действительного ожидаемого времени прибытия для отмены
Поездка недействительна и не может быть отменена.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Нет действительного ожидаемого времени прибытия для отмены |
type | https://developers.nest.com/reference/error-messages#no-valid-eta-to-cancel |
message | Нет действительного ожидаемого времени прибытия для отмены |
Нет разрешения на запись для поля (полей)
У клиента нет разрешения на запись этих данных. Дополнительные сведения см. в разделе Обзор разрешений .
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Нет прав на запись для полей: $fields |
type | https://developers.nest.com/reference/error-messages#no-write-permission |
message | Нет прав на запись для полей: $fields |
details | $fields |
Недопустимый тип запроса
Тип запроса недействителен. Например, вызов POST был сделан, когда требуется PUT.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Недопустимый тип запроса: $requestType |
type | https://developers.nest.com/reference/error-messages#request-type-not-allowed |
message | Недопустимый тип запроса: $requestType |
details | $requestType |
Не найден
Вызов попытался прочитать несуществующий путь.
Параметры | |
---|---|
Код состояния HTTP: 404 не найден | |
error | Не найден |
type | https://developers.nest.com/reference/error-messages#not-found |
message | Не найден |
Не в режиме «Ушел»
Структура не находится в режиме «Нет на месте», когда делается вызов ETA. Вызовы ETA принимаются только в том случае, если для структуры установлено значение «Нет на месте».
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Не в режиме «Ушел» |
type | https://developers.nest.com/reference/error-messages#not-in-away-mode |
message | Не в режиме «Ушел» |
Недоступно для записи
Поле, в которое вы пытаетесь записать, доступно только для чтения.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Недоступно для записи |
type | https://developers.nest.com/reference/error-messages#not-writable |
message | Недоступно для записи |
Только там, где необходимо указать имя
Дополнительные поля были включены в вызов wheres
.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Только там, где необходимо указать имя |
type | https://developers.nest.com/reference/error-messages#extra-fields |
message | Только там, где необходимо указать имя |
POST не является допустимым типом запроса
Недопустимый тип запроса. Например, вызов POST был сделан, когда требуется PUT.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | POST не является допустимым типом запроса |
type | https://developers.nest.com/reference/error-messages#invalid-request-type |
message | POST не является допустимым типом запроса |
Нарушение схемы
Произошла ошибка при сопряжении устройств.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Нарушение схемы |
type | https://developers.nest.com/reference/error-messages#schema-violation-error |
message | Нарушение схемы |
Сервис недоступен
Параметры | |
---|---|
Код состояния HTTP: 503 Служба недоступна | |
error | Сервис недоступен |
type | https://developers.nest.com/reference/error-messages#service-unavailable |
message | Сервис недоступен |
В структуре уже есть максимально допустимое количество сопряженных устройств.
В структуре уже есть максимально допустимое количество устройств .
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | В структуре уже есть максимально допустимое количество сопряженных устройств. |
type | https://developers.nest.com/reference/error-messages#max-number-devices-error |
message | В структуре уже есть максимально допустимое количество сопряженных устройств. |
Структура не принадлежит пользователю
structure_id
не соответствует учетной записи пользователя записи.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Структура не принадлежит пользователю. |
type | https://developers.nest.com/reference/error-messages#structure-ownership-error-uri |
message | Структура не принадлежит пользователю. |
Температура C слишком высока для температуры блокировки
Пользователь заблокировал термостат, и изделие попыталось установить целевую температуру в градусах Цельсия выше диапазона блокировки.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Температура C $tempC слишком высока для температуры блокировки $highLockTemp |
type | https://developers.nest.com/reference/error-messages#high-c-value-4-lock |
message | Температура C $tempC слишком высока для температуры блокировки $highLockTemp |
details | $tempC |
Температура C слишком низкая для температуры блокировки
Пользователь заблокировал термостат, и изделие попыталось установить целевую температуру по Цельсию ниже диапазона блокировки.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Температура C $tempC слишком низкая для температуры блокировки $lowLockTemp |
type | https://developers.nest.com/reference/error-messages#low-c-value-4-lock |
message | Температура C $tempC слишком низкая для температуры блокировки $lowLockTemp |
details | $tempC |
Слишком высокое значение температуры C
Продукт попытался установить целевое значение температуры, которое слишком велико для температуры по шкале Цельсия. Допустимые диапазоны температур в градусах Цельсия см. в разделе target_temperature_c
.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Слишком высокое значение температуры C: $tempC |
type | https://developers.nest.com/reference/error-messages#high-c-value |
message | Слишком высокое значение температуры C: $tempC |
details | $tempC |
Слишком низкое значение температуры C
Продукт попытался установить целевое значение температуры, которое слишком низко для температуры Цельсия. Допустимые диапазоны температур в градусах Цельсия см. в разделе target_temperature_c
.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Слишком низкое значение температуры C: $tempC |
type | https://developers.nest.com/reference/error-messages#low-c-value |
message | Слишком низкое значение температуры C: $tempC |
details | $tempC |
Температура F слишком высока для температуры блокировки
Термостат был заблокирован пользователем, и продукт попытался установить целевую температуру по Фаренгейту выше диапазона блокировки.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Температура F $tempF слишком высока для температуры блокировки $highLockTemp |
type | https://developers.nest.com/reference/error-messages#high-f-value-4-lock |
message | Температура F $tempF слишком высока для температуры блокировки $highLockTemp |
details | $tempF |
Температура F слишком низкая для температуры блокировки
Термостат был заблокирован пользователем, и продукт попытался установить целевую температуру по Фаренгейту ниже диапазона блокировки.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Температура F $tempF слишком низкая для температуры блокировки $lowLockTemp |
type | https://developers.nest.com/reference/error-messages#low-f-value-4-lock |
message | Температура F $tempF слишком низкая для температуры блокировки $lowLockTemp |
details | $tempF |
Слишком высокое значение температуры F
Продукт попытался установить целевое значение температуры, которое слишком велико для температуры по Фаренгейту. Допустимые диапазоны температур в градусах Фаренгейта см. в target_temperature_f
.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Слишком высокое значение температуры F: $tempF |
type | https://developers.nest.com/reference/error-messages#high-f-value |
message | Слишком высокое значение температуры F: $tempF |
details | $tempF |
Значение температуры F слишком низкое
Продукт попытался установить целевое значение температуры, слишком низкое для температуры по Фаренгейту. Допустимые диапазоны температур в градусах Фаренгейта см. в target_temperature_f
.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Значение температуры F слишком низкое: $tempF |
type | https://developers.nest.com/reference/error-messages#low-f-value |
message | Значение температуры F слишком низкое: $tempF |
details | $tempF |
Температура в неправильном формате
Продукт попытался установить целевую temperature_scale
, используя неправильный числовой формат для выбранного значения Temperature_scale . Температуры по Цельсию должны быть целыми числами с шагом 0,5 градуса (21,5), а температуры по Фаренгейту должны быть целыми числами (72).
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Температура $temp имеет неверный формат |
type | https://developers.nest.com/reference/error-messages#format-error |
message | Температура $temp имеет неверный формат |
details | $temp |
Поле (я) не может быть изменено при обновлении
Продукт попытался записать в поле только для чтения.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Поля не могут быть изменены при обновлении: $fieldNames |
type | https://developers.nest.com/reference/error-messages#read-only-field-error |
message | Поля не могут быть изменены при обновлении: $fieldNames |
details | $fieldNames |
Поля должны использовать формат ISO 8601.
Поле не в формате ISO 8601 .
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Поля должны использовать формат ISO 8601: $fieldNames |
type | https://developers.nest.com/reference/error-messages#time-format-error |
message | Поля должны использовать формат ISO 8601: $fieldNames |
details | $fieldNames |
Термостат не в сети
В настоящее время термостат отключен. После включения Wi-Fi ваш продукт должен восстановить доступ.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Термостат не в сети |
type | https://developers.nest.com/reference/error-messages#not-online |
message | Термостат не в сети |
Эта поездка была отменена вручную
Пользователь вручную отменил поездку.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Эта поездка была отменена вручную |
type | https://developers.nest.com/reference/error-messages#trip-manually-overidden |
message | Эта поездка была отменена вручную |
Не удалось создать где ID
Объект wheres
отсутствует. Значения where_id
не определены.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Не удалось создать, где id |
type | https://developers.nest.com/reference/error-messages#wheres-missing |
message | Не удалось создать, где id |
Неавторизованный
Авторизация не удалась.
Несколько условий могут генерировать это сообщение об ошибке:
неправильные перенаправления, возникающие, когда данная реализация HTTP не перенаправляет автоматически заголовок авторизации на перенаправленный URI. Дополнительные сведения см. в разделе Как обрабатывать перенаправления .
неправильные разрешения при попытке доступа к конечным точкам API. Например, попытка прочитать конечную точку термостата, когда для клиента выбраны только разрешения камеры. Дополнительные сведения см. в разделе Как выбрать разрешения .
Параметры | |
---|---|
Код состояния HTTP: 401 Неавторизованный | |
error | Неавторизованный |
type | https://developers.nest.com/reference/error-messages#auth-error |
message | Неавторизованный |
Неизвестный
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | неизвестный |
type | https://developers.nest.com/reference/error-messages#unknown |
message | неизвестный |
Неизвестный производитель/тип устройства
Производитель/устройство не распознается во время сопряжения устройств.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Неизвестный производитель/тип устройства |
type | https://developers.nest.com/reference/error-messages#unknown-vendor-device-type-error |
message | Неизвестный производитель/тип устройства |
Значение $fieldName имеет неправильный тип
Был отправлен неправильный тип данных. Например, отправка строки, когда ожидается логическое значение.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Значение $fieldName имеет неправильный тип |
type | https://developers.nest.com/reference/error-messages#wrong-data-type |
message | Значение $fieldName имеет неправильный тип |
details | $fieldName |
Где имя уже существует
Название where_name
, которое пытался установить продукт, уже существует. Попробуйте еще раз с новым именем.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Где имя $name уже существует |
type | https://developers.nest.com/reference/error-messages#where-name-exists |
message | Где имя $name уже существует |
details | $name |
Где имя не указано
В вызове отсутствует where_name
.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Где имя не указано |
type | https://developers.nest.com/reference/error-messages#where-name-missing |
message | Где имя не указано |
Где имя имеет нулевую длину
name
where не определено (имеет нулевые символы).
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Где имя имеет нулевую длину |
type | https://developers.nest.com/reference/error-messages#zero-length-where-name |
message | Где имя имеет нулевую длину |
Где имя должно быть строкой
Для where_name
был отправлен неверный тип данных. Например, число, когда ожидается строка.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Где имя должно быть строкой |
type | https://developers.nest.com/reference/error-messages#where-name-wrong-format |
message | Где имя должно быть строкой |
где_id не существует
where_id
недействителен.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | где_id не существует |
type | https://developers.nest.com/reference/error-messages#where-id-invalid |
message | где_id не существует |
details | $where_id |
где_id должен быть строкой
Недопустимый формат where_id
. Например, вместо строки было отправлено число.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | где_id должен быть строкой |
type | https://developers.nest.com/reference/error-messages#where-id-wrong-format |
message | где_id должен быть строкой |
Другие коды ошибок и сообщения
Коды ошибок устройства
Коды ошибок и сообщения для конкретных устройств, не связанные с Nest API, см. в следующих разделах:
Коды ошибок REST
Когда вы делаете вызов REST API, возвращаются общие коды состояния HTTP.
Сообщения об ограничении скорости REST
При использовании REST и отправке слишком большого количества вызовов за короткий промежуток времени вы можете получить код состояния ответа HTTP 429 Too Many Requests.
Дополнительные сведения см. в разделе Ограничения скорости передачи данных .
,Ошибочные состояния являются частью цикла разработки и могут варьироваться от простых ошибок, таких как недопустимый или отсутствующий параметр, до более сложных сценариев, таких как непредвиденное состояние или даже настройки, связанные с устройством, которые необходимо разрешать вне API.
При возникновении ошибки во время вызова API отправляется ответ в таком формате:
{ "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" } }
Все сообщения об ошибках содержат поля error
, type
, message
и instance
. Объект details
является необязательным.
Поле | Описание |
---|---|
error | Короткий формат сообщения об ошибке. |
type | Предоставляет URL-адрес для подробной информации об ошибке (эта страница). |
message | Формат длинного сообщения об ошибке, в котором могут использоваться переменные для предоставления дополнительных сведений. Когда переменная включена в сообщение, она появится в объекте details . |
instance | Текстовая строка, содержащая идентификатор ошибки, уникальный для каждого отдельного вызова. Мы можем запросить у вас номер экземпляра, если вы сообщите о проблеме со службой. |
details | Необязательный. Содержит переменные, которые вставляются в message . Сообщения могут содержать несколько переменных. |
Информацию об ошибках, не связанных с Nest API, см. в разделе Другие коды ошибок и сообщения .
Заблокировано
Лимит скорости превышен.
Параметры | |
---|---|
Код состояния HTTP: 429 Слишком много запросов | |
error | Заблокировано |
type | https://developers.nest.com/reference/error-messages#blocked |
message | Заблокировано |
Невозможно активировать вентилятор во время отключения дыма / угарного газа
Аварийное отключение действует. Вызовы API не принимаются до тех пор, пока не будет восстановлена нормальная работа.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Невозможно активировать вентилятор во время отключения дыма / угарного газа |
type | https://developers.nest.com/reference/error-messages#safety-shutoff-on |
message | Невозможно активировать вентилятор во время отключения дыма / угарного газа |
Невозможно изменить состояние «Нет на месте», пока включено аварийное отопление
Устройство пыталось изменить состояние «Нет на месте» при включенном аварийном нагреве .
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Невозможно изменить состояние «Нет на месте», пока включено аварийное отопление |
type | https://developers.nest.com/reference/error-messages#emergency-heat-is-on |
message | Невозможно изменить состояние «Нет на месте», пока включено аварийное отопление |
Невозможно изменить режим HVAC во время энергосберегающих мероприятий
Действует энергосберегающее мероприятие , определенное энергетическим партнером Nest. Вызовы API отклоняются до окончания события энергосбережения.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Невозможно изменить режим HVAC во время энергосберегающих мероприятий |
type | https://developers.nest.com/reference/error-messages#energy-saving-event-on |
message | Невозможно изменить режим HVAC во время энергосберегающих мероприятий |
Невозможно изменить режим HVAC
Режим несовместим с запросом.
Например, вы можете получить это сообщение, если:
- Система HVAC термостата не поддерживает режим, запрошенный вашим продуктом:
heat
,cool
,heat-cool
илиeco
. - Режим HVAC установлен на
eco
, и продукт пытается установитьtarget_temperature
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Невозможно изменить режим HVAC на $mode ; HVAC не может $action |
type | https://developers.nest.com/reference/error-messages#incompatible-mode |
message | Невозможно изменить режим HVAC на $mode ; HVAC не может $action |
details | $mode |
Невозможно изменить режим HVAC, пока включена блокировка термостата
Пользователь должен разблокировать термостат , прежде чем продукт сможет записывать данные.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Невозможно изменить режим HVAC, пока включена блокировка термостата |
type | https://developers.nest.com/reference/error-messages#lock-enabled |
message | Невозможно изменить режим HVAC, пока включена блокировка термостата |
Невозможно установить температуры C и F одновременно
Продукт пытался одновременно установить целевые температуры в градусах Цельсия и Фаренгейта. Продукт должен устанавливать только целевую температуру, указанную в temperature_scale
(C/F).
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Невозможно установить температуры C и F одновременно |
type | https://developers.nest.com/reference/error-messages#multiple-value-changes |
message | Невозможно установить температуры C и F одновременно |
Невозможно включить/выключить fan_timer_active из-за несовместимого режима
Вентилятор системы ОВКВ уже включен (либо вручную пользователем, либо по расписанию, либо из-за цикла обогрева/охлаждения ОВКВ).
Если вы не получите ожидаемого результата, это, скорее всего, связано с тем, что устройство имеет встроенное поведение, которое мы не можем переопределить через API.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Невозможно включить/выключить fan_timer_active из-за несовместимого режима $mode |
type | https://developers.nest.com/reference/error-messages#incompatible-fan-mode |
message | Невозможно включить/выключить fan_timer_active из-за несовместимого режима $mode |
details | $mode |
Невозможно установить для fan_timer_duration выбранное значение
Продукт попытался установить для fan_timer_duration
недопустимое значение. Смотрите fan_timer_duration
для списка допустимых значений.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Невозможно установить для fan_timer_duration выбранное значение. См. справочник по API для допустимых значений. |
type | https://developers.nest.com/reference/error-messages#invalid-fan-timer-duration |
message | Невозможно установить для fan_timer_duration выбранное значение. См. справочник по API для допустимых значений. |
Невозможно установить целевую низкую температуру выше целевой высокой температуры
Термостат находится в режиме heat-cool
, и устройство попыталось установить целевую температуру ниже/высокой, которая находится за пределами допустимого диапазона. Например, продукт попытался установить target_temperature_low_c
25 °C, когда target_temperature_high_c
равно 24 °C.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Невозможно установить целевую низкую температуру $lowTemp выше целевой высокой температуры $highTemp |
type | https://developers.nest.com/reference/error-messages#low-high-error |
message | Невозможно установить целевую низкую температуру $lowTemp выше целевой высокой температуры $highTemp |
details | $lowTemp |
Невозможно установить целевую температуру ближе, чем N градусов C/F.
Продукт попытался установить целевое значение температуры слишком близко к целевому высокому/низкому значению температуры (например, target_temperature_high_f
).
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Невозможно установить целевую температуру ближе, чем N градусов C/F. |
type | https://developers.nest.com/reference/error-messages#range-error |
message | Невозможно установить целевую температуру ближе, чем $min градусов $scale |
details | $min $scale |
Невозможно установить целевую_температуру, пока режим равен $mode.
Термостат или конструкция в настоящее время находятся в режиме, который не поддерживает запросы API.
Например, вы не можете установить target_temperature_f
или target_temperature_c
когда система HVAC off
или находится в режиме heat-cool
. Значение не может быть изменено до тех пор, пока термостат/конструкция не переключится обратно в неограниченный режим.
В этом сообщении $fieldName
может быть любым значением целевой температуры, а $mode
может быть любым из: eco
, emer_heat_enable
, heat-cool
, heat
, cool
, off
, hvac_safety_shutoff_active
.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Невозможно установить целевую_температуру, пока режим равен $mode |
type | https://developers.nest.com/reference/error-messages#mode-error |
message | Невозможно установить $fieldName , пока режим равен $mode |
details | $fieldName |
Перед изменением режима HVAC требуется обновление микропрограммы устройства.
Устройство должно быть обновлено до текущей версии прошивки, чтобы установить экотемпературу.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Перед изменением режима HVAC требуется обновление микропрограммы устройства. Обновления автоматические, как правило, в течение недели после выпуска. |
type | https://developers.nest.com/reference/error-messages#unsupported-firmware-version |
message | Перед изменением режима HVAC требуется обновление микропрограммы устройства. Обновления автоматические, как правило, в течение недели после выпуска. |
Ошибка при проверке полей WWN
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Ошибка при проверке полей WWN: $error |
type | https://developers.nest.com/reference/error-messages#where-id-internal |
message | Ошибка при проверке полей WWN: $error |
details | $error |
ЭТА в прошлом
Указанное время ETA находится в прошлом (до СЕЙЧАС). Дополнительную информацию о вызовах ETA см. в Руководстве по отсутствию и ETA .
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Расчетное время прибытия в прошлом: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime |
type | https://developers.nest.com/reference/error-messages#eta-in-the-past |
message | Расчетное время прибытия в прошлом: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime |
details | $estimatedArrivalTime |
ETA слишком далеко в будущем
Указанное время ETA не может превышать 8 часов в будущем. Дополнительную информацию о вызовах ETA см. в Руководстве по отсутствию и ETA .
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | ETA слишком далеко в будущем |
type | https://developers.nest.com/reference/error-messages#eta-too-far-in-the-future |
message | ETA слишком далеко в будущем |
fan_timer_active не установлен
fan_timer_active
не определен.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | fan_timer_active не установлен |
type | https://developers.nest.com/reference/error-messages#fan-timer-active-value-missing |
message | fan_timer_active не установлен |
Запрещенный
Учетные данные, используемые для доступа к службе Nest, недействительны.
Параметры | |
---|---|
Код состояния HTTP: 403 Запрещено | |
error | Запрещенный |
type | https://developers.nest.com/reference/error-messages#forbidden |
message | Запрещенный |
Внутренняя ошибка
Параметры | |
---|---|
Код состояния HTTP: 500 Внутренняя ошибка сервера | |
error | Внутренняя ошибка |
type | https://developers.nest.com/reference/error-messages#internal-error |
message | Внутренняя ошибка |
Неверный идентификатор камеры
Идентификатор camera-id
недействителен.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Недопустимый идентификатор камеры $id |
type | https://developers.nest.com/reference/error-messages#invalid-camera-id |
message | Неверный идентификатор камеры: $id |
details | $id |
Недействительный контент отправлен
Вызов содержит недопустимый контент. Например, используя «да» вместо «истина» для логической переменной.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Недействительный контент отправлен |
type | https://developers.nest.com/reference/error-messages#invalid-content-sent |
message | Недействительный контент отправлен |
Неверный путь к фрагменту
Часть пути запроса недействительна. Например, имя объекта или поля может быть написано с ошибкой.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Неверный путь фрагмента: $requestPath |
type | https://developers.nest.com/reference/error-messages#invalid-fragment |
message | Неверный путь фрагмента: $requestPath |
details | $requestPath |
Неверный режим HVAC
Система HVAC термостата не поддерживает режим, запрошенный продуктом: heat
, cool
или heat-cool
.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Неверный режим HVAC: $mode |
type | https://developers.nest.com/reference/error-messages#invalid-mode |
message | Неверный режим HVAC: $mode |
details | $mode |
Неверный идентификатор датчика дыма и угарного газа
smoke_co_alarm_id
.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Неверный идентификатор дымовой и угарной сигнализации $id |
type | https://developers.nest.com/reference/error-messages#invalid-smoke-co-alarm-id |
message | Недействительный идентификатор датчика дыма и угарного газа: $id |
details | $id |
Недопустимый идентификатор структуры
structure_id
недействителен.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Недопустимый идентификатор структуры $id |
type | https://developers.nest.com/reference/error-messages#invalid-structure-id |
message | Недопустимый идентификатор структуры: $id |
details | $id |
Неверный идентификатор термостата
thermostat_id
недействителен.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Неверный идентификатор термостата $id |
type | https://developers.nest.com/reference/error-messages#invalid-thermostat-id |
message | Неверный идентификатор термостата: $id |
details | $id |
Неверное значение для Нет дома
Вы пытались установить недопустимое значение для away
.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Неверное значение для Нет дома |
type | https://developers.nest.com/reference/error-messages#invalid-away-value |
message | Неверное значение: $value . Допустимыми значениями являются только «дома» и «в гостях». |
details | $value |
is_streaming не является логическим значением
Продукт попытался установить для поля is-streaming
значение, не являющееся логическим.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | is_streaming не является логическим значением |
type | https://developers.nest.com/reference/error-messages#invalid-is-stream-format |
message | is_streaming не является логическим значением |
Ярлык должен содержать менее 256 символов.
Продукт попытался создать этикетку термостата, содержащую более 256 символов.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Метка должна содержать менее $max_label_length символов. |
type | https://developers.nest.com/reference/error-messages#max-label-length |
message | Метка должна содержать менее $max_label_length символов. |
details | $max_label_length |
Макс. пользовательский, где превышено количество
Продукт попытался создать пользовательский объект wheres
сверх максимального количества. Максимально допустимое количество настраиваемых объектов wheres
— 32.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Макс. пользовательское значение, при котором превышено количество $max_where_count |
type | https://developers.nest.com/reference/error-messages#max-where-count |
message | Макс. пользовательское значение, при котором превышено количество $max_where_count |
details | $max_where_count |
Max custom, где длина имени превышена
Слишком длинное name
. Мы рекомендуем менее 30 символов.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Max custom, где длина имени $max_custom_where_name_length превышена |
type | https://developers.nest.com/reference/error-messages#max-where-name-length |
message | Max custom, где длина имени $max_custom_where_name_length превышена |
details | $max_custom_where_name_length |
Отсутствует поле
В вызове отсутствует обязательный параметр.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Отсутствует поле: $fieldName |
type | https://developers.nest.com/reference/error-messages#field-is-missing |
message | Отсутствует поле: $fieldName |
details | $fieldName |
Отсутствует где ID
Отсутствует формат where_id
.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Отсутствует идентификатор |
type | https://developers.nest.com/reference/error-messages#where-id-missing |
message | Отсутствует идентификатор |
Нет вентилятора ОВКВ
В системе HVAC нет отдельного вентилятора.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Нет вентилятора ОВК |
type | https://developers.nest.com/reference/error-messages#no-hvac-fan |
message | Нет вентилятора ОВК |
Нет онлайн-термостатов
В настоящее время термостат отключен. После включения Wi-Fi ваш продукт должен восстановить доступ.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Нет онлайн-термостатов |
type | https://developers.nest.com/reference/error-messages#no-thermostats-online |
message | Нет онлайн-термостатов |
Нет сопряженных устройств
Устройства Nest пользователя не связаны с его учетной записью Nest .
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Нет сопряженных устройств |
type | https://developers.nest.com/reference/error-messages#no-paired-devices |
message | Нет сопряженных устройств |
Нет действительного ожидаемого времени прибытия для отмены
Поездка недействительна и не может быть отменена.
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | Нет действительного ожидаемого времени прибытия для отмены |
type | https://developers.nest.com/reference/error-messages#no-valid-eta-to-cancel |
message | Нет действительного ожидаемого времени прибытия для отмены |
Нет разрешения на запись для поля (полей)
У клиента нет разрешения на запись этих данных. Дополнительные сведения см. в разделе Обзор разрешений .
Параметры | |
---|---|
Код состояния HTTP: 400 неверный запрос | |
error | No write permission(s) for field(s): $fields |
type | https://developers.nest.com/reference/error-messages#no-write-permission |
message | No write permission(s) for field(s): $fields |
details | $fields |
Not a valid request type
The request type is not valid. For example, a POST call was made when a PUT is required.
Parameters | |
---|---|
HTTP Status Code: 400 Bad Request | |
error | Not a valid request type: $requestType |
type | https://developers.nest.com/reference/error-messages#request-type-not-allowed |
message | Not a valid request type: $requestType |
details | $requestType |
Not found
The call attempted to read a path that doesn't exist.
Parameters | |
---|---|
HTTP Status Code: 404 Not Found | |
error | Not found |
type | https://developers.nest.com/reference/error-messages#not-found |
message | Not found |
Not in Away mode
The structure is not in Away mode when an ETA call is made. ETA calls are only accepted when the structure is set to Away.
Parameters | |
---|---|
HTTP Status Code: 400 Bad Request | |
error | Not in Away mode |
type | https://developers.nest.com/reference/error-messages#not-in-away-mode |
message | Not in Away mode |
Not writable
The field you're attempting to write to is read-only.
Parameters | |
---|---|
HTTP Status Code: 400 Bad Request | |
error | Not writable |
type | https://developers.nest.com/reference/error-messages#not-writable |
message | Not writable |
Only where name needs to be provided
Extra fields were included in the wheres
call.
Parameters | |
---|---|
HTTP Status Code: 400 Bad Request | |
error | Only where name needs to be provided |
type | https://developers.nest.com/reference/error-messages#extra-fields |
message | Only where name needs to be provided |
POST is not a valid request type
The request type is invalid. For example, a POST call was made when a PUT is required.
Parameters | |
---|---|
HTTP Status Code: 400 Bad Request | |
error | POST is not a valid request type |
type | https://developers.nest.com/reference/error-messages#invalid-request-type |
message | POST is not a valid request type |
Schema violation
An occurred error when pairing devices.
Parameters | |
---|---|
HTTP Status Code: 400 Bad Request | |
error | Schema violation |
type | https://developers.nest.com/reference/error-messages#schema-violation-error |
message | Schema violation |
Service unavailable
Parameters | |
---|---|
HTTP Status Code: 503 Service Unavailable | |
error | Service Unavailable |
type | https://developers.nest.com/reference/error-messages#service-unavailable |
message | Service Unavailable |
Structure already has maximum number of paired devices allowed
The structure already has the maximum number of allowed devices .
Parameters | |
---|---|
HTTP Status Code: 400 Bad Request | |
error | Structure already has maximum number of paired devices allowed |
type | https://developers.nest.com/reference/error-messages#max-number-devices-error |
message | Structure already has maximum number of paired devices allowed |
Structure is not owned by the user
The structure_id
does not match the user account of record.
Parameters | |
---|---|
HTTP Status Code: 400 Bad Request | |
error | Structure is not owned by the user. |
type | https://developers.nest.com/reference/error-messages#structure-ownership-error-uri |
message | Structure is not owned by the user. |
Temperature C is too high for lock temperature
The thermostat has been locked by the user and the product attempted to set a Celsius target temperature higher than the lock temperature range.
Parameters | |
---|---|
HTTP Status Code: 400 Bad Request | |
error | Temperature C $tempC is too high for lock temperature $highLockTemp |
type | https://developers.nest.com/reference/error-messages#high-c-value-4-lock |
message | Temperature C $tempC is too high for lock temperature $highLockTemp |
details | $tempC |
Temperature C is too low for lock temperature
The thermostat has been locked by the user and the product attempted to set a Celsius target temperature lower than the lock temperature range.
Parameters | |
---|---|
HTTP Status Code: 400 Bad Request | |
error | Temperature C $tempC is too low for lock temperature $lowLockTemp |
type | https://developers.nest.com/reference/error-messages#low-c-value-4-lock |
message | Temperature C $tempC is too low for lock temperature $lowLockTemp |
details | $tempC |
Temperature C value is too high
The product attempted to set a target temperature value that is too high for a Celsius temperature. For allowed temperature ranges in Celsius see target_temperature_c
.
Parameters | |
---|---|
HTTP Status Code: 400 Bad Request | |
error | Temperature C value is too high: $tempC |
type | https://developers.nest.com/reference/error-messages#high-c-value |
message | Temperature C value is too high: $tempC |
details | $tempC |
Temperature C value is too low
The product attempted to set a target temperature value that is too low for a Celsius temperature. For allowed temperature ranges in Celsius see target_temperature_c
.
Parameters | |
---|---|
HTTP Status Code: 400 Bad Request | |
error | Temperature C value is too low: $tempC |
type | https://developers.nest.com/reference/error-messages#low-c-value |
message | Temperature C value is too low: $tempC |
details | $tempC |
Temperature F is too high for lock temperature
The thermostat has been locked by the user and the product attempted to set a Fahrenheit target temperature higher than the lock temperature range.
Parameters | |
---|---|
HTTP Status Code: 400 Bad Request | |
error | Temperature F $tempF is too high for lock temperature $highLockTemp |
type | https://developers.nest.com/reference/error-messages#high-f-value-4-lock |
message | Temperature F $tempF is too high for lock temperature $highLockTemp |
details | $tempF |
Temperature F is too low for lock temperature
The thermostat has been locked by the user and the product attempted to set a Fahrenheit target temperature lower than the lock temperature range.
Parameters | |
---|---|
HTTP Status Code: 400 Bad Request | |
error | Temperature F $tempF is too low for lock temperature $lowLockTemp |
type | https://developers.nest.com/reference/error-messages#low-f-value-4-lock |
message | Temperature F $tempF is too low for lock temperature $lowLockTemp |
details | $tempF |
Temperature F value is too high
The product attempted to set a target temperature value that is too high for a Fahrenheit temperature. For allowed temperature ranges in Fahrenheit see target_temperature_f
.
Parameters | |
---|---|
HTTP Status Code: 400 Bad Request | |
error | Temperature F value is too high: $tempF |
type | https://developers.nest.com/reference/error-messages#high-f-value |
message | Temperature F value is too high: $tempF |
details | $tempF |
Temperature F value is too low
The product attempted to set a target temperature value that is too low for a Fahrenheit temperature. For allowed temperature ranges in Fahrenheit see target_temperature_f
.
Parameters | |
---|---|
HTTP Status Code: 400 Bad Request | |
error | Temperature F value is too low: $tempF |
type | https://developers.nest.com/reference/error-messages#low-f-value |
message | Temperature F value is too low: $tempF |
details | $tempF |
Temperature is in wrong format
The product attempted to set a target temperature using the wrong number format for the chosen temperature_scale
. Celsius temperatures should be integers in 0.5 degree increments (21.5), and Fahrenheit temperatures should be whole integers (72).
Parameters | |
---|---|
HTTP Status Code: 400 Bad Request | |
error | Temperature $temp is in wrong format |
type | https://developers.nest.com/reference/error-messages#format-error |
message | Temperature $temp is in wrong format |
details | $temp |
The field(s) cannot be modified on update
The product attempted to write to a read-only field.
Parameters | |
---|---|
HTTP Status Code: 400 Bad Request | |
error | The field(s) cannot be modified on update: $fieldNames |
type | https://developers.nest.com/reference/error-messages#read-only-field-error |
message | The field(s) cannot be modified on update: $fieldNames |
details | $fieldNames |
The field(s) should use ISO 8601 format
The field is not in ISO 8601 format.
Parameters | |
---|---|
HTTP Status Code: 400 Bad Request | |
error | The field(s) should use ISO 8601 format: $fieldNames |
type | https://developers.nest.com/reference/error-messages#time-format-error |
message | The field(s) should use ISO 8601 format: $fieldNames |
details | $fieldNames |
Thermostat is not online
The thermostat is currently offline. After wi-fi is enabled, your product should regain access.
Parameters | |
---|---|
HTTP Status Code: 400 Bad Request | |
error | Thermostat is not online |
type | https://developers.nest.com/reference/error-messages#not-online |
message | Thermostat is not online |
This trip has been manually overridden
The user has manually overridden the trip.
Parameters | |
---|---|
HTTP Status Code: 400 Bad Request | |
error | This trip has been manually overridden |
type | https://developers.nest.com/reference/error-messages#trip-manually-overidden |
message | This trip has been manually overridden |
Unable to create where ID
The wheres
object is missing. No where_id
values are defined.
Parameters | |
---|---|
HTTP Status Code: 400 Bad Request | |
error | Unable to create where id |
type | https://developers.nest.com/reference/error-messages#wheres-missing |
message | Unable to create where id |
Unauthorized
Authorization has failed.
A couple of conditions may generate this error message:
incorrect redirects that occur when a given HTTP implementation does not automatically forward the Authorization header to the redirected URI. For more information, see How to handle redirects .
incorrect permissions when trying to access API endpoints. For example, trying to read a Thermostat endpoint when only Camera permissions are selected for the client. For more information, see How to choose permissions .
Parameters | |
---|---|
HTTP Status Code: 401 Unauthorized | |
error | Unauthorized |
type | https://developers.nest.com/reference/error-messages#auth-error |
message | Unauthorized |
Unknown
Parameters | |
---|---|
HTTP Status Code: 400 Bad Request | |
error | unknown |
type | https://developers.nest.com/reference/error-messages#unknown |
message | unknown |
Unknown vendor/device type
Vendor/device not recognized during device pairing.
Parameters | |
---|---|
HTTP Status Code: 400 Bad Request | |
error | Unknown vendor/device type |
type | https://developers.nest.com/reference/error-messages#unknown-vendor-device-type-error |
message | Unknown vendor/device type |
Value of $fieldName is of wrong type
The wrong data type was sent. For example, sending a string when a boolean is expected.
Parameters | |
---|---|
HTTP Status Code: 400 Bad Request | |
error | Value of $fieldName is of wrong type |
type | https://developers.nest.com/reference/error-messages#wrong-data-type |
message | Value of $fieldName is of wrong type |
details | $fieldName |
Where name already exists
The where_name
the product tried to set already exists. Try again with a new name.
Parameters | |
---|---|
HTTP Status Code: 400 Bad Request | |
error | Where name $name already exists |
type | https://developers.nest.com/reference/error-messages#where-name-exists |
message | Where name $name already exists |
details | $name |
Where name is not provided
The where_name
is missing from the call.
Parameters | |
---|---|
HTTP Status Code: 400 Bad Request | |
error | Where name is not provided |
type | https://developers.nest.com/reference/error-messages#where-name-missing |
message | Where name is not provided |
Where name is of zero length
The where name
is not defined (has zero characters).
Parameters | |
---|---|
HTTP Status Code: 400 Bad Request | |
error | Where name is of zero length |
type | https://developers.nest.com/reference/error-messages#zero-length-where-name |
message | Where name is of zero length |
Where name must be a string
The wrong data type was sent for the where_name
. For example, a number when a string is expected.
Parameters | |
---|---|
HTTP Status Code: 400 Bad Request | |
error | Where name must be a string |
type | https://developers.nest.com/reference/error-messages#where-name-wrong-format |
message | Where name must be a string |
where_id does not exist
The where_id
is invalid.
Parameters | |
---|---|
HTTP Status Code: 400 Bad Request | |
error | where_id does not exist |
type | https://developers.nest.com/reference/error-messages#where-id-invalid |
message | where_id does not exist |
details | $where_id |
where_id must be a string
The where_id
format is invalid. For example, a number was sent instead of a string.
Parameters | |
---|---|
HTTP Status Code: 400 Bad Request | |
error | where_id must be a string |
type | https://developers.nest.com/reference/error-messages#where-id-wrong-format |
message | where_id must be a string |
Other error codes and messages
Device error codes
For device-specific error codes and messages unrelated to the Nest API, see the following:
REST error codes
When you make a REST API call, common HTTP status codes are returned.
REST rate limit messages
When using REST and you send too many calls in a short period of time, you may receive a HTTP response status code of 429 Too Many Requests.
For more information, see Data Rate Limits .