简体中文
简体中文
English
联系我们
注册
登录

门锁标准指令集和状态集

更新时间:2022-03-18 07:21:14下载pdf

门锁非raw类型dp点,如设备状态上报dp点、开门记录dp点、告警记录dp点,需要通过订阅标准指令和状态集集dp来获取对应dp内容和参数值。

门锁通用能力下发控制

门锁标准指令和标准控制dp点参考:

云开发平台-智能门锁标准指令集和状态集 >> 云开发平台-设备控制 >>

门锁解锁方式录入结果推送

支持的门锁类型

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

参数说明

参数名 类型 说明
bizCode String 事件类型码
devId String 设备 ID
uuid Integer 设备 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 权限非法