Response codes
Request successful
- If the request was processed without errors, your API must respond with the 200 OK code.
- 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 theerror_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 |
|
404 |
Not Found |
The resource has not been found at the given path. |
500 |
Internal Server Error |
Internal server error. |