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

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

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

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 .