Сообщения об ошибках,Сообщения об ошибках

Ошибочные состояния являются частью цикла разработки и могут варьироваться от простых ошибок, таких как недопустимый или отсутствующий параметр, до более сложных сценариев, таких как непредвиденное состояние или даже настройки, связанные с устройством, которые необходимо разрешать вне 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 $action

Невозможно изменить режим 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 $highTemp

Невозможно установить целевую температуру ближе, чем 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 $mode

Перед изменением режима 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 $currentTime

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 $highLockTemp

Температура 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 $lowLockTemp

Слишком высокое значение температуры 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 $highLockTemp

Температура 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 $lowLockTemp

Слишком высокое значение температуры 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, см. в следующих разделах:

• Коды ошибок термостата Nest
• Коды ошибок Nest Cam или Dropcam

Коды ошибок 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 $action

Невозможно изменить режим 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 $highTemp

Невозможно установить целевую температуру ближе, чем 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 $mode

Перед изменением режима 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 $currentTime

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 $highLockTemp

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 $lowLockTemp

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 $highLockTemp

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 $lowLockTemp

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:

• Nest Thermostat error codes
• Nest Cam or Dropcam error codes

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 .