Response codes

Request successful

  1. If the request was processed without errors, your API must respond with the 200 OK code.
  2. If a device-related error occurs during request execution, your API must respond with HTTP 200 OK and one of the supported codes. Use the error_code parameter to pass the code, and the error_message parameter to pass the error description.

Error code

Brief description

Text of error in the app

Alice's phrase

Error example

DOOR_OPEN

The door is open

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

Translation: Don't forget to close the door.

Ой, кажется, открыта дверца. Закройте её и повторите команду.

Translation: Oh, the door seems to be open. Close it and repeat the command.

Command to start washing with the door of the washing machine not closed securely

LID_OPEN

The lid is open

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

Translation: Don't forget to close the lid.

Упс, кажется, вы забыли закрыть крышку. Закройте её и повторите команду.

Translation: Oops, it seems you forgot to close the lid. Close it and repeat the command.

Cooking program on a multicooker started with the lid open

REMOTE_CONTROL_DISABLED

Remote control is disabled for the device

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

Translation: First ask for permission from the device: check for a button on the device.

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

Translation: First ask for permission from the device: check for a button on the device.

Controlling a device with remote control disabled

NOT_ENOUGH_WATER

Not enough water

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

Translation: Try adding water.

Ой, недостаточно воды. Долейте её и повторите команду.

Translation: Oh no, there's not enough water. Add more water and repeat the command.

Kettle or humidifier started without water

LOW_CHARGE_LEVEL

Low charge level

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

Translation: Charge the device.

Кажется, устройство разрядилось. Пожалуйста, повторите после зарядки.

Translation: It seems the device has run out of power. Please try again after charging.

Robotic vacuum cleaner started with a low battery level

CONTAINER_FULL

The container is full

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

Translation: Empty the container first.

Кажется, контейнер переполнился. Очистите его и повторите команду.

Translation: The container is too full. Empty it and repeat the command.

Robotic vacuum cleaner started with a full dust container. Coffee maker started with a full waste coffee container

CONTAINER_EMPTY

The container is empty

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

Translation: Put something inside the container.

Ой, кажется, вы забыли положить кофе — контейнер пуст. Наполните его и повторите команду.

Translation: It looks like you forgot to put the coffee beans in. The container is empty. Fill it up and repeat the command.

Coffee maker started with an empty bean container

DRIP_TRAY_FULL

Drip tray is full

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

Translation: Clean the tray.

Заполнился сливной поддон. Очистите и повторите команду.

Translation: The drain tray is full. Clean it and repeat the command.

Coffee maker started with a full drain tray

DEVICE_STUCK

The device is stuck

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

Translation: It looks like there's something in the way, please remove it.

Аларм, возникло препятствие! Пожалуйста, устраните его.

Translation: Oops, there's something in the way! Please move it.

Command to a robotic vacuum cleaner that got stuck

DEVICE_OFF

The device is off

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

Translation: Turn on the device first.

Ой, не получается. Сначала включите устройство.

Translation: Oops, something went wrong. Turn on the device first.

Command to a device that's turned off. If your device is not connected to a power source or the internet, use the DEVICE_UNREACHABLE error code

FIRMWARE_OUT_OF_DATE

The firmware is outdated

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

Translation: Update the firmware of the device you want to control.

Не могу запустить без обновления. Пожалуйста, обновите прошивку вашему устройству (речь не обо мне).

Translation: I can't run it without an update. Please update the firmware of your device (we're not talking about me).

Command for a device with an outdated firmware version that fails to support the specified command

NOT_ENOUGH_DETERGENT

There is not enough detergent

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

Translation: Add detergent.

Я бы рада, да закончилось моющее средство. Добавьте его и повторите команду.

Translation: I'd love to, but there's no detergent. Add it and repeat the command.

Dishwasher started without any detergent

HUMAN_INVOLVEMENT_NEEDED

Human involvement is needed

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

Translation: Something's wrong with the device, please inspect it.

Кажется, что-то пошло не так. Для устранения ошибки нужна ваша помощь.

Translation: Something went wrong. I need your help to fix the error.

Washing machine started with an overloaded drum.

DEVICE_UNREACHABLE

The device is unavailable

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

Translation: The device is not responding. Check whether it's turned off or the internet is down.

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

Translation: I can't find the device, please check its connection.

Device started with power off or internet off

DEVICE_BUSY

The device is busy

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

Translation: The device is already running. Wait until it finishes.

Прямо сейчас устройство занято, попробуйте позднее.

Translation: Right now the device is busy, try again later.

Command to a washing machine that's already running the washing program

INTERNAL_ERROR

An unknown internal error

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

Translation: Something unknown has happened. Wait a while and try again.

Что-то пошло не так. Подождите немного и попробуйте снова.

Translation: Something went wrong. Wait a bit and try again.

Any unclassified error on the platform partner side

INVALID_ACTION

An invalid action

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

Translation: This device can't do that. Try doing something else.

Устройство сообщает мне, что оно этого не умеет.

Translation: The device says that it doesn't know how to do that.

Command to change the brightness of light on the washing machine without the relevant skill

INVALID_VALUE

Invalid value

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

Translation: Some unknown value. Try a different one.

Не нахожу такой возможности, увы.

Translation: I am afraid this is impossible.

A command to set a value outside of the allowed range: turning to channel 150 on a TV with 100 channels available

NOT_SUPPORTED_IN_CURRENT_MODE

Not supported in the current device mode

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

Translation: This command is not supported in this mode.

В текущем режиме это невозможно.

Translation: This isn't possible in the current mode.

The command to change the temperature of the air conditioner in ventilation mode (the air is not cooled or heated in this mode)

ACCOUNT_LINKING_ERROR

Error in the user's OAuth2 token

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

Translation: Try to link the device once again because it's unlinked.

Устройство отвязалось, необходимо снова связать аккаунты в приложении Яндекса.

Translation: This device is now unlinked, you need to link your accounts in the Yandex app again.

An attempt to control a device with an expired or disabled OAuth2 token

DEVICE_NOT_FOUND

Device not found

Данное устройство вам не принадлежит.

Translation: You don't own this device.

Не могу найти такое устройство.

Translation: I can't find this device.

The user deleted the device in the manufacturer's app

Request with error

The Yandex Smart Home platform uses the HTTP protocol and supports all the standard state codes. In some cases, we recommend using the codes from the table below.

Error code

Description

Explanation

400

Bad Request

Error in the request.

401

Unauthorized

The authorization token wasn't passed.

403

Forbidden

  • The user does not exist.
  • No rights to access the resource.

404

Not Found

The resource has not been found at the given path.

500

Internal Server Error

Internal server error.