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 Yasmina's phrase Error example

DOOR_OPEN

The door is open

Don't forget to close the door.

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

Don't forget to close the lid.

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

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

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

Try adding water.

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

Charge the device.

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

Empty the container first.

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

Put something inside the container.

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

Clean the tray.

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

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

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

Turn on the device first.

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

Update the firmware of the device you want to control.

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

Add detergent.

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

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

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

Washing machine started with an overloaded drum.

DEVICE_UNREACHABLE

The device is unavailable

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

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

Device started with power off or internet off

DEVICE_BUSY

The device is busy

The device is already running. Wait until it finishes.

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

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

Something went wrong. Wait a bit and try again.

Any unclassified error on the platform partner side

INVALID_ACTION

An invalid action

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

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

Some unknown value. Try a different one.

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

This command is not supported in this mode.

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

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

This device is now unlinked, you need to link your accounts in the  Yango Play app again.

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

DEVICE_NOT_FOUND

Device not found

You don't own this device.

I can't find this device.

The user deleted the device in the manufacturer's app

Error code Brief description Text of error in the app Yasmina's phrase Error example

DOOR_OPEN

The door is open

Don't forget to close the door.

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

Don't forget to close the lid.

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

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

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

Try adding water.

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

Charge the device.

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

Empty the container first.

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

Put something inside the container.

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

Clean the tray.

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

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

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

Turn on the device first.

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

Update the firmware of the device you want to control.

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

Add detergent.

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

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

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

Washing machine started with an overloaded drum.

DEVICE_UNREACHABLE

The device is unavailable

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

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

Device started with power off or internet off

DEVICE_BUSY

The device is busy

The device is already running. Wait until it finishes.

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

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

Something went wrong. Wait a bit and try again.

Any unclassified error on the platform partner side

INVALID_ACTION

An invalid action

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

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

Some unknown value. Try a different one.

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

This command is not supported in this mode.

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

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

This device is now unlinked, you need to link your accounts in the  Yango Play app again.

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

DEVICE_NOT_FOUND

Device not found

You don't own this device.

I can't find this device.

The user deleted the device in the manufacturer's app

Request with error

The Yango 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.
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.

Support