Instruction & Status Set

For smart door locks, except raw type data points (DPs), you need to subscribe to the standard instruction set and status set DPs. This way, you can get the DP content and parameter values, such as DPs for device status reporting, unlocking history, and alert history.

Send instructions to control locks

Standard instructions are used to control the general capabilities of smart locks. For more information, see the standard instruction set and status set of smart locks and the API Get device details in the subsequent sections.

Push notifications of unlocking method enrollment results

For more information, see Enroll in unlocking methods.

Applicable lock types

• Wi-Fi lock
• Zigbee lock
• Bluetooth lock
• Wi-Fi access control devices
• Smart video locks
• Bluetooth accessories
• Keepalive Wi-Fi locks

Parameters

bizCode

bizData

Data format

{
    "bizCode":"doorUnlockMethodStatus",
    "bizData":{
        "finish":false,
        "operate":1,
        "raised":true,
        "totalPeriod":2,
        "period":2,
        "event":"unlockMethodEntry"
    },
    "uuid":"xxxx",
    "devId":"xxxx"
}

Get device details

For more information, see the Device Control API.

API description

Query the device details, including the instruction set and the latest status of the specified device.

API endpoint

GET /v1.0/devices/{device_id}

Request parameters

Response parameters

Description of result

Description of status

Sample request

GET /v1.0/devices/vdevo153490924188132

Sample SDK

TuyaClient client = new TuyaClient(clientId, secret, RegionEnum.CN);
DeviceVo deviceVo = client.getDeviceInfo(DEV_ID);
System.out.println("Get device details: ");
System.out.println(JSONObject.toJSONString(deviceVo));

Sample response

{
    "success": true,
    "result": {
        "active_time": 1589505938,
        "biz_type": 299009,
        "category": "qt",
        "create_time": 1560827137,
        "icon": "smart/icon/15402589135gknz23xajb_0.png",
        "id": "60613135b121cddc294****",
        "ip": "120.198.****.****",
        "local_key": "3a9b50126fe473****",
        "name": "Body fat scale",
        "online": true,
        "owner_id": "1070****",
        "product_id": "g0er6hSKgMqr****",
        "product_name": "Wifi scales_OEM",
        "status": [
            {
                "code": "weight",
                "value": "48900"
            },
            {
                "code": "left_hand_r",
                "value": "0"
            },
            {
                "code": "right_hand_r",
                "value": "0"
            },
            {
                "code": "left_leg_r",
                "value": "0"
            },
            {
                "code": "right_leg_r",
                "value": "0"
            },
            {
                "code": "body_r",
                "value": "653"
            },
            {
                "code": "battery_low",
                "value": "false"
            }
        ],
        "sub": false,
        "time_zone": "+08:00",
        "uid": "ay157896239864843g****",
        "update_time": 1589764585,
        "uuid": "60613135b23cddc294****"
    }
}

Error codes

The following table lists common error codes returned in the API calls. For more error codes, see Global Error Codes.