Lock Vision

May 16, 2026 ยท View on GitHub


Device List Information

KeyValue TypeDescription
deviceIdStringdevice ID
deviceNameStringdevice name
deviceTypeStringdevice type. Lock Vision
enableCloudServiceBooleandetermines if Cloud Service is enabled or not for the current device
hubDeviceIdStringdevice's parent Hub ID
keyListObjecta list of passcodes

keyList maintains a list of passcodes,

KeyValue TypeDescription
idIntegerpasscode ID
nameStringname of the passcode
typeStringtype of the passcode. permanent, a permanent passcode. timeLimit, a temporary passcode. disposable, a one-time passcode.
passwordStringthe passcode string encrypted with the developer secret key using the aes-128-cbc algorithm
ivStringan arbitrary number used for the encryption
statusStringvalidity of the passcode. normal, the passcode is valid. expired, the passcode is invalid.
createTimeLongthe time when the passcode is generated

Device Status

KeyValue TypeDescription
deviceIdStringdevice ID
deviceTypeStringdevice type. Lock Vision
hubDeviceIdStringdevice's parent Hub ID
batteryIntegerthe current battery level, 0-100
versionStringthe current firmware version, e.g. V6.3
lockStateStringjammed, unlock, lock, latchBoltLocked
doorStateStringopen, close
calibrateBooleandetermines if Lock has been calibrated or not
onlineStatusStringthe connection status of the device. online or offline

Control Commands

deviceTypecommandTypeCommandcommand parameterDescription
Lock Visioncommandlockdefaultrotate to locked position
Lock Visioncommandunlockdefaultrotate to unlocked position
Lock VisioncommanddeleteKey{"id": ""}delete a passcode by id
Lock VisioncommandcreateKey{"name":"","type":"","password":"","startTime":0,"endTime":0}create a passcode

Webhook Events

Key NameValue TypeDescription
eventTypeStringthe type of events
eventVersionStringthe current event version
contextObjectthe detail info of the event
deviceTypeStringthe type of the device
deviceMacStringthe MAC address of the device
lockStateStringthe state of the device, "LOCKED" stands for the motor is rotated to locking position; "UNLOCKED" stands for the motor is rotated to unlocking position; "JAMMED" stands for the motor is jammed while rotating
batteryIntegerthe battery level
timeOfSampleLongthe time stamp when the event is sent
{
    "eventType": "changeReport",
    "eventVersion": "1",
    "context": {
        "deviceType": "W1141000",
        "deviceMac": DEVICE_MAC_ADDR,
        "lockState": "LOCKED",
        "battery": 90,
        "timeOfSample": 123456789
    }
}