Коды ответа

Успешный запрос

  1. Если запрос был обработан без ошибок, ваш API должен отвечать кодом 200 OK.
  2. Если во время выполнения запроса произошла ошибка, связанная с устройствами, ваш API должен отвечать HTTP-кодом 200 ОК и одним из поддерживаемых кодов. Код передавайте в параметре error_code, а описание ошибки — в параметре error_message.

Код ошибки Краткое описание Текст ошибки в приложении Пример возникновения ошибки

DOOR_OPEN

Открыта дверца

Не забудьте закрыть дверцу

Запуск стирки при неплотно закрытой дверце стиральной машинки

LID_OPEN

Открыта крышка

Не забудьте закрыть крышку

Запуск программы приготовления на мультиварке с открытой крышкой

REMOTE_CONTROL_DISABLED

Удаленное управление устройством отключено

Сначала нужно спросить разрешения у самого устройства: проверьте, на нём должна быть специальная кнопка

Управление устройством, у которого отключена функция удаленного управления

NOT_ENOUGH_WATER

Недостаточно воды

Попробуйте долить воды

Запуск чайника или увлажнителя без воды

LOW_CHARGE_LEVEL

Низкий уровень заряда

Устройство нужно зарядить

Запуск робота-пылесоса с разряженной батареей

CONTAINER_FULL

Контейнер полон

Сначала нужно очистить контейнер

Запуск робота-пылесоса с переполненным контейнером для пыли. Запуск кофеварки с переполненным контейнером для отработанного кофе

CONTAINER_EMPTY

Контейнер пуст

В контейнер нужно что-нибудь положить

Запуск кофеварки с пустым контейнером для зерен

DRIP_TRAY_FULL

Сливной поддон полон

Нужно очистить поддон

Запуск кофеварки с переполненным сливным поддоном

DEVICE_STUCK

Устройство застряло

Кажется, на пути препятствие, его нужно убрать

Команда застрявшему роботу-пылесосу

DEVICE_OFF

Устройство выключено

Сначала нужно включить устройство

Команда выключенному устройству. Если устройство отключено от электричества или от сети интернет, используйте код ошибки DEVICE_UNREACHABLE

FIRMWARE_OUT_OF_DATE

Прошивка устарела

Нужно обновить прошивку устройства, которым хотите управлять

Команда устройству с устаревшей версией прошивки, которая не позволяет выполнить указанную команду

NOT_ENOUGH_DETERGENT

Недостаточно моющего средства

Добавьте моющее средство

Запуск посудомоечной машины без моющего средства

HUMAN_INVOLVEMENT_NEEDED

Требуется вмешательство человека

Что-то не так с устройством: пожалуйста, осмотрите его

Запуск стиральной машины с перегруженным барабаном.

DEVICE_UNREACHABLE

Устройство недоступно

Устройство не отвечает. Проверьте, вдруг оно выключено или пропал интернет.

Запуск устройства, отключенного от электричества или от сети интернет

DEVICE_BUSY

Устройство занято

Устройство уже работает. Подождите, пока оно закончит.

Команда стиральной машине, которая уже выполняет программу стирки

INTERNAL_ERROR

Неизвестная внутренняя ошибка

Случилось что-то непонятное. Подождите немного и попробуйте ещё раз.

Любая неклассифицируемая ошибка на стороне платформы партнера

INVALID_ACTION

Недопустимое действие

Это устройство так не умеет. Попробуйте что-нибудь другое.

Команда изменения яркости света на стиральной машине без соответствующего умения

INVALID_VALUE

Недопустимое значение

Какое-то незнакомое значение. Попробуйте другое.

Команда на установку значения вне допустимого диапазона — включение 150-го канала на телевизоре при доступных 100

NOT_SUPPORTED_IN_CURRENT_MODE

Не поддерживается в текущем режиме работы устройства

В этом режиме такая команда не работает

Команда на изменение температуры кондиционера, находящегося в режиме вентиляции (в данном режиме охлаждение или нагрев воздуха не происходит)

ACCOUNT_LINKING_ERROR

Ошибка в OAuth2 токене пользователя

Попробуйте привязать устройство заново, а то оно отвязалось

Попытка управлять устройством с просроченным или инвалидированным OAuth2 токеном

Код ошибки Краткое описание Текст ошибки в приложении Пример возникновения ошибки

DOOR_OPEN

Открыта дверца

Не забудьте закрыть дверцу

Запуск стирки при неплотно закрытой дверце стиральной машинки

LID_OPEN

Открыта крышка

Не забудьте закрыть крышку

Запуск программы приготовления на мультиварке с открытой крышкой

REMOTE_CONTROL_DISABLED

Удаленное управление устройством отключено

Сначала нужно спросить разрешения у самого устройства: проверьте, на нём должна быть специальная кнопка

Управление устройством, у которого отключена функция удаленного управления

NOT_ENOUGH_WATER

Недостаточно воды

Попробуйте долить воды

Запуск чайника или увлажнителя без воды

LOW_CHARGE_LEVEL

Низкий уровень заряда

Устройство нужно зарядить

Запуск робота-пылесоса с разряженной батареей

CONTAINER_FULL

Контейнер полон

Сначала нужно очистить контейнер

Запуск робота-пылесоса с переполненным контейнером для пыли. Запуск кофеварки с переполненным контейнером для отработанного кофе

CONTAINER_EMPTY

Контейнер пуст

В контейнер нужно что-нибудь положить

Запуск кофеварки с пустым контейнером для зерен

DRIP_TRAY_FULL

Сливной поддон полон

Нужно очистить поддон

Запуск кофеварки с переполненным сливным поддоном

DEVICE_STUCK

Устройство застряло

Кажется, на пути препятствие, его нужно убрать

Команда застрявшему роботу-пылесосу

DEVICE_OFF

Устройство выключено

Сначала нужно включить устройство

Команда выключенному устройству. Если устройство отключено от электричества или от сети интернет, используйте код ошибки DEVICE_UNREACHABLE

FIRMWARE_OUT_OF_DATE

Прошивка устарела

Нужно обновить прошивку устройства, которым хотите управлять

Команда устройству с устаревшей версией прошивки, которая не позволяет выполнить указанную команду

NOT_ENOUGH_DETERGENT

Недостаточно моющего средства

Добавьте моющее средство

Запуск посудомоечной машины без моющего средства

HUMAN_INVOLVEMENT_NEEDED

Требуется вмешательство человека

Что-то не так с устройством: пожалуйста, осмотрите его

Запуск стиральной машины с перегруженным барабаном.

DEVICE_UNREACHABLE

Устройство недоступно

Устройство не отвечает. Проверьте, вдруг оно выключено или пропал интернет.

Запуск устройства, отключенного от электричества или от сети интернет

DEVICE_BUSY

Устройство занято

Устройство уже работает. Подождите, пока оно закончит.

Команда стиральной машине, которая уже выполняет программу стирки

INTERNAL_ERROR

Неизвестная внутренняя ошибка

Случилось что-то непонятное. Подождите немного и попробуйте ещё раз.

Любая неклассифицируемая ошибка на стороне платформы партнера

INVALID_ACTION

Недопустимое действие

Это устройство так не умеет. Попробуйте что-нибудь другое.

Команда изменения яркости света на стиральной машине без соответствующего умения

INVALID_VALUE

Недопустимое значение

Какое-то незнакомое значение. Попробуйте другое.

Команда на установку значения вне допустимого диапазона — включение 150-го канала на телевизоре при доступных 100

NOT_SUPPORTED_IN_CURRENT_MODE

Не поддерживается в текущем режиме работы устройства

В этом режиме такая команда не работает

Команда на изменение температуры кондиционера, находящегося в режиме вентиляции (в данном режиме охлаждение или нагрев воздуха не происходит)

ACCOUNT_LINKING_ERROR

Ошибка в OAuth2 токене пользователя

Попробуйте привязать устройство заново, а то оно отвязалось

Попытка управлять устройством с просроченным или инвалидированным OAuth2 токеном

Запрос с ошибкой

Платформа умного дома работает по протоколу HTTP и поддерживает все стандартные коды состояний. В отдельных случаях, рекомендуется использовать коды, описанные в таблице ниже.

Код ошибки Описание Пояснение
400 Bad Request Ошибка в запросе.
401 Unauthorized Не передан авторизационный токен.
403 Forbidden
  • Пользователь не существует.
  • Отсутствует доступ к запрашиваемому ресурсу.
404 Not Found Ресурс по указанному пути не найден.
500 Internal Server Error Сервер недоступен.
Код ошибки Описание Пояснение
400 Bad Request Ошибка в запросе.
401 Unauthorized Не передан авторизационный токен.
403 Forbidden
  • Пользователь не существует.
  • Отсутствует доступ к запрашиваемому ресурсу.
404 Not Found Ресурс по указанному пути не найден.
500 Internal Server Error Сервер недоступен.