门锁标准指令集和状态集

门锁中，除了透传（Raw）类型之外的 DP（Data Point)，例如设备状态上报 DP、开门记录 DP、告警记录 DP，需要通过订阅标准指令和状态集 DP，才能获取对应 DP 内容和参数值。

下发门锁通用能力控制

门锁通用能力下发控制一般通过标准指令实现，详情请参考 智能门锁标准指令集和状态集 和下文 获取设备详情 接口。

录入解锁方式结果推送

更多详情，请参考 门锁解锁方式录入。

支持的门锁类型

• Wi-Fi 门锁
• Zigbee 门锁
• 蓝牙门锁
• Wi-Fi 门禁
• 可视对讲门锁
• 蓝牙配件
• 保活 Wi-Fi 门锁

参数说明

参数名	类型	说明
bizCode	String	事件类型码
devId	String	设备 ID
uuid	String	设备 UUID
bizData	Object	解锁方式状态
ts	Long	时间戳

bizCode

bizCode	说明
doorUnlockMethodStatus	门锁解锁方式状态

bizData

code	数据类型	说明
finish	Boolean	是否完成录入
operate	Integer	操作 1：发起操作 2：取消操作
raised	Boolean	是否已发起
totalPeriod	Integer	总录入次数（会单独且只会推送一次总录入次数）
period	Integer	剩余录入次数
event	String	事件： unlockMethodEntry：录入解锁方式 unlockMethodDelete：删除解锁方式

数据格式

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

获取设备详情

更多详情，请参考 设备控制 接口。

接口描述

可查询设备的详情信息，包括设备指令集和设备最新状态。

接口地址

GET /v1.0/devices/{device_id}

请求参数

参数名	类型	参数类型	必填	说明
device_id	String	URI	是	设备 ID

返回参数

参数名	类型	说明
code	Integer	响应码，详见 错误码。
success	Boolean	判断请求是否成功。 true：成功 false：失败
msg	String	请求失败返回的信息，成功则返回空值。
result	Object<result>	返回结果。

result 说明

参数名	类型	说明
id	String	设备编号
name	String	设备名称
uid	String	用户 ID
local_key	String	密钥
category	String	产品类别
product_id	String	产品 ID
product_name	String	产品名称
sub	Boolean	判断是否为子设备 true：是 false：不是
uuid	String	设备唯一标识
owner_id	String	家庭 ID
online	Boolean	设备在线状态
status	Object<status>	设备功能状态
active_time	Long	设备激活时间，时间戳，精确到秒
biz_type	Long	应用 biztype
icon	String	设备图标
ip	String	设备 IP

status 说明

参数名	类型	说明
code	String	功能点 Code
value	String	功能点的值
type	String	功能点的类型

请求示例

GET /v1.0/devices/vdevo153490924188132

SDK 示例

TuyaClient client = new TuyaClient(clientId, secret, RegionEnum.CN);
DeviceVo deviceVo = client.getDeviceInfo(DEV_ID);
System.out.println("获取设备信息: ");
System.out.println(JSONObject.toJSONString(deviceVo));

返回示例

{
    "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": "体脂秤",
        "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****"
    }
}

错误码

以下为该接口常见的业务异常，更多的异常错误，请参考 全局错误码。

错误码	说明
500	系统错误
1106	权限非法