Keypad Vision Pro

---

Device List Information

Key	Value Type	Description
deviceId	String	device ID
deviceName	String	device name
deviceType	String	device type. Keypad Vision Pro
enableCloudService	Boolean	determines if Cloud Service is enabled or not for the current device
hubDeviceId	String	device's parent Hub ID
lockDeviceId	String	MAC address of the Lock that the current device is paired with
keyList	Object	a list of passcodes

---

Device Status

Key	Value Type	Description
deviceId	String	device ID
deviceType	String	device type. Keypad Vision Pro
hubDeviceId	String	device's parent Hub ID

---

Control Commands

The control commands for this product work differently than the other products. Due to security concerns, the passcodes are stored locally. This mechanism dramatically prolongs the time needed to successfully create a passcode and get the correct result through the Web API. Hence, the actual results of the following commands are returned from the SwitchBot server asynchronously and are delivered through a webhook.

You need to configure a webhook to receive the correct result. Refer to this product's webhook definition.

deviceType	commandType	Command	command parameter	Description
Keypad Vision Pro	command	createKey	{ "name": passcode _name_str, "type": passcode_type_str, "password": passcode_str, "startTime": valid_from_long, "endTime": valid_to_long }	create a new passcode
Keypad Vision Pro	command	deleteKey	{ "id": passcode_id_int }	delete an existing passcode

The following table describes the parameter object for createKey,

Key Name	Value Type	Description
name	String	a unique name for the passcode. duplicates under the same device are not allowed.
type	String	type of the passcode. permanent, a permanent passcode. timeLimit, a temporary passcode. disposable, a one-time passcode. urgent, an emergency passcode.
password	String	a 6 to 12-digit passcode in plain text
startTime	Long	set the time the passcode becomes valid from, mandatory for one-time passcode and temporary passcode. a 10-digit timestamp.
endTime	Long	set the time the passcode becomes expired, mandatory for one-time passcode and temporary passcode. a 10-digit timestamp.

The following table describes the parameter object for deleteKey,

Key Name	Value Type	Description
id	String	the id of the passcode

---

Webhook Events

Key Name	Value Type	Description
eventType	String	the type of events
eventVersion	String	the current event version
context	Object	the detail info of the event
deviceType	String	the type of the device
deviceMac	String	the MAC address of the device
eventName	String	attributes of the context object. the name of the command being sent
commandId	String	attributes of the context object. the command id
result	String	attributes of the context object. the result of the command. success, failed, or timeout. timeout duration is 1 minute
timeOfSample	Long	the time stamp when the event is sent

Create a passcode

{
    "eventType": "changeReport",
    "eventVersion": "1",
    "context": {
        "deviceType": "Keypad Vision Pro",
        "deviceMac": DEVICE_MAC_ADDR,
        "eventName": "createKey",
        "commandId": "CMD-1663558451952-01",
        "result": "success",
        "timeOfSample": 123456789
    }
}

Delete a passcode

{
    "eventType": "changeReport",
    "eventVersion": "1",
    "context": {
        "deviceType": "Keypad Vision Pro",
        "deviceMac": DEVICE_MAC_ADDR,
        "eventName": "deleteKey ",
        "commandId": "CMD-1663558451952-01",
        "result": "success",
        "timeOfSample": 123456789
    }
}