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 | 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 |
|
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 |
|
404 | Not Found | The resource has not been found at the given path. |
500 | Internal Server Error | Internal server error. |