K20+ Pro

May 16, 2026 · View on GitHub


Device List Information

KeyValue TypeDescription
deviceIdStringdevice ID
deviceNameStringdevice name
deviceTypeStringdevice type. Robot Vacuum Cleaner K20 Plus Pro
enableCloudServiceBooleandetermines if Cloud Service is enabled or not for the current device
hubDeviceIdStringdevice's parent Hub ID. 000000000000 when the device itself is a Hub or it is connected through Wi-Fi.

Device Status

KeyValue TypeDescription
deviceIdStringdevice ID
deviceTypeStringdevice type. Robot Vacuum Cleaner K20 Plus Pro
hubDeviceIdStringdevice's parent Hub ID
workingStatusStringthe working status of the device. StandBy, Clearing, Paused, GotoChargeBase, Charging, ChargeDone, Dormant, InTrouble, InRemoteControl, or InDustCollecting
onlineStatusStringthe connection status of the device. online or offline
batteryIntegerthe current battery level 0-100
taskTypeStringthe current task in progress. standBy, explore, cleanAll, cleanArea, cleanRoom, backToCharge, collectDust, remoteControl, cleanWithExplorer

Control Commands

deviceTypecommandTypeCommandcommand parameterDescription
K20+ ProcommandstartClean{"action": action_str, "param": {"fanLevel": fan_level_int, "times": clean_cycle_int}}start cleaning.
action_str, the cleaning mode, sweep or mop.
fanLevel, the vacuum level, 1-4.
times, the number of cycles, 1-2639999, in theory.
K20+ Procommandpausedefaultpause cleaning
K20+ Procommanddockdefaultreturn to charging dock
K20+ ProcommandsetVolume{0-100}set the robot volume
K20+ ProcommandchangeParam{"fanLevel": fan_level_int, "waterLevel": water_level_int, "times": clean_cycle_int}change clean parameters. fan_level_int, the vacuum level, 1-4; water_level_int, the mop moisture level, 1-2; times, the number of cycles, 1-2639999, in theory.

Webhook Events

Key NameValue TypeDescription
eventTypeStringthe type of events
eventVersionStringthe current event version
contextObjectthe detail info of the event
deviceTypeStringattributes of the context object. the type of the device
deviceMacStringattributes of the context object. the MAC address of the device
workingStatusStringattributes of the context object. the working status of the device. StandBy, Clearing, Paused, GotoChargeBase, Charging, ChargeDone, Dormant, InTrouble, InRemoteControl, or InDustCollecting
onlineStatusStringattributes of the context object. the connection status of the device. online or offline
batteryIntegerattributes of the context object. the battery level, range from 0 to 100
taskTypeStringattributes of the context object. the current task in progress. standBy, explore, cleanAll, cleanArea, cleanRoom, backToCharge, collectDust, remoteControl, cleanWithExplorer
timeOfSampleLongattributes of the context object. the time stamp when the event is sent
{
    "eventType": "changeReport",
    "eventVersion": "1",
    "context": {
        "deviceType": "Robot Vacuum Cleaner K20+ Pro",
        "deviceMac": DEVICE_MAC_ADDR,
        "workingStatus""StandBy",
        //StandBy,Clearing,Paused,GotoChargeBase,Charging,ChargeDone,Dormant,InTrouble,InRemoteControl,InDustCollecting
        "onlineStatus": "online",//online,offline
        "battery": 100,// 0-100
        "taskType": "explore", // standBy,explore,cleanAll,cleanArea,cleanRoom,deepWashing,backToCharge,drying,collectDust,remoteControl,cleanWithExplorer
        "timeOfSample": 123456789
    }
}