接口说明:

  • 房间列表查询

业务能力:

  • openSmartRoomList

本地服务器版本:

  • V2.1.0

Content-Version:

  • 1.0

功能变化:

  • 1.增加房间状态返回

参数:

参数名层级必选类型说明备注
startNum1int开始记录数默认为0
pageSize1int分页大小默认10,最大50
请求示例
{
    "method": "openSmartRoomList",
    "tokenId": "aFqJ9GbjlmX0LHZosmciPH3Ewt4S53FdqhmpCsliBF5FkEoCQ7gSlijO9DTm8aZl/xV6UpARSkWSy/Go4HfWaA==",
    "data": {
        "startNum": 0,
        "pageSize": 10
    }
}

响应示例

{
    "msgId": 27232299,
    "resultCode": 0,
    "reason": "",
    "method": "openSmartRoomList",
    "data": {
        "roomList": [{
                "roomName": "0216",
                "buildingCode": 1,
                "floorCode": 1,
                "roomCode": 101,
                "lockCode": "1.1.101",
                "isVisible": 1,
                "lockMac": "6077712264da",
                "hardwareVersion": "FMTBL-01LP-HDKFX V2A",
                "softwareVersion": "01000444",
                "aesKey": "5JgpPPi8M+jWhUaIljzcjyKI8T0quSSVyhzTu5Lak24=",
                "adminAuthCode": "ZK/Mv2Gu8swTwsZWIlEuYw==",
                "generalAuthCode": "wJdwEgeSS1LcR/IMJd49uQ==",
                "tempAuthCode": "tlwfBTQe3azLEOC4ctFZKQ==",
				"roomState":1
            }, {
                "roomName": "103",
                "buildingCode": 1,
                "floorCode": 1,
                "roomCode": 103,
                "lockCode": "1.1.103",
                "isVisible": 1,
                "lockMac": "0cec80e804d0",
                "hardwareVersion": "M157-9905BCT-FKHF V1",
                "softwareVersion": "01000444",
                "aesKey": "WVbBneUskUcbmz5lUJSv5PLa/gDXG7VZsAk6HIB05NI=",
                "adminAuthCode": "hPm9zXdXcLq2NmcDvQ4dzw==",
                "generalAuthCode": "HLA1l+XQAl2fuf7rlPIYfA==",
                "tempAuthCode": "dD4lHk/zk3Bqd+l6VuR1Lw==",
				"roomState":1
            }, {
                "roomName": "103A",
                "buildingCode": 1,
                "floorCode": 1,
                "roomCode": 103,
                "subRoomName": "A",
                "lockCode": "1.1.103A",
                "isVisible": 1,
                "lockMac": "806fb0517c47",
                "hardwareVersion": "MTBL-HXJ01-HF-FK V2A",
                "softwareVersion": "01000433",
                "aesKey": "A6426qo8zJPuRX1axoh3avx1eLixFBl8buykQkFTuv8=",
                "adminAuthCode": "uUGILDQ+DmG9AVHfMa9J3g==",
                "generalAuthCode": "VdxRF2p9SgJ9SI7IopzuLw==",
                "tempAuthCode": "RmFeAIKTeqDhoCzA20pQ2g==",
				"roomState":1
            }, {
                "roomName": "330",
                "buildingCode": 1,
                "floorCode": 1,
                "roomCode": 330,
                "lockCode": "1.1.330",
                "isVisible": 1,
                "lockMac": "e4e112d62a67",
                "hardwareVersion": "FMTBL-01LP-HDKFX V2A",
                "softwareVersion": "01000442",
                "aesKey": "Io7yX8gn+WpPDO5GeqfnDNdlcrbM5rQqGaMoUx9oAxE=",
                "adminAuthCode": "MAq4jkq8z9992dMSa1Y99Q==",
                "generalAuthCode": "f3DZmMfYojq+5E08nDiCQA==",
                "tempAuthCode": "k2BbsyEzI5Bd22rPt5KsIQ==",
				"roomState":1
            }, {
                "roomName": "1011",
                "buildingCode": 1,
                "floorCode": 1,
                "roomCode": 1011,
                "lockCode": "1.1.1011",
                "isVisible": 1,
                "lockMac": "806fb0518534",
                "hardwareVersion": "MTBL-HXJ01-HFKF V2A",
                "softwareVersion": "01000444",
                "aesKey": "AETaEfDq/ZGXZAmKVKf8aPrscKUsAC61GxLcSh1Z9Ks=",
                "adminAuthCode": "i9B4i8kVfoiUgBuIEAVTMA==",
                "generalAuthCode": "gAUUZ8hKyNcU3jwOJYGE1A==",
                "tempAuthCode": "SMGGUOlFXfv/ZNahhjOe2w==",
				"roomState":1
            }, {
                "roomName": "201",
                "buildingCode": 1,
                "floorCode": 2,
                "roomCode": 201,
                "lockCode": "1.2.201",
                "isVisible": 1,
                "lockMac": "806fb051887b",
                "hardwareVersion": "MTBL-HXJ01-HF-FK V20",
                "softwareVersion": "01000448",
                "aesKey": "tx8Uao7D435CQiGz93Tawk0HFyMp1p9iCzzYcKP4evg=",
                "adminAuthCode": "CAqgmyGBP0FSmWz4kuvwJg==",
                "generalAuthCode": "ajmRDLwUyn2XMRVbjGQM6g==",
                "tempAuthCode": "ddp1VIgmiS8Yx5dW3kb2zw==",
				"roomState":1
            }, {
                "roomName": "201A",
                "buildingCode": 1,
                "floorCode": 2,
                "roomCode": 201,
                "subRoomName": "A",
                "lockCode": "1.2.201A",
                "isVisible": 1,
                "lockMac": "806fb0518514",
                "hardwareVersion": "MTBL-HXJ01-HF-FK V20",
                "softwareVersion": "01000448",
                "aesKey": "zkcTTWK85O0L/D/aA5Cfqgg1isbCvonk7PuULQDg35I=",
                "adminAuthCode": "7mzT908VeuvJYDZwxU3OWw==",
                "generalAuthCode": "N1WbpqqRhXnkpVc/X3iKkA==",
                "tempAuthCode": "xcbBYa8ewZmoY6zJDl05lA==",
				"roomState":1
            }, {
                "roomName": "201B",
                "buildingCode": 1,
                "floorCode": 2,
                "roomCode": 201,
                "subRoomName": "B",
                "lockCode": "1.2.201B",
                "isVisible": 1,
                "lockMac": "e4e112d62a57",
                "hardwareVersion": "FMTBL-01LP-HDKFX V2A",
                "softwareVersion": "01000442",
                "aesKey": "S23pdqLU2iIatrt5xwP7Z5/vIn0q0Mwa3KIAcwVHQ6Y=",
                "adminAuthCode": "v/d8wctHujKgfe8fi+nveA==",
                "generalAuthCode": "Sp0G/P3/ZaoVXu4vObVbKg==",
                "tempAuthCode": "cdnyOPUJxlGCDfxTXMNv3A==",
				"roomState":1
            }, {
                "roomName": "202-未顶替",
                "buildingCode": 1,
                "floorCode": 2,
                "roomCode": 202,
                "lockCode": "1.2.202",
                "isVisible": 1,
				"roomState":1
            }, {
                "roomName": "203-未顶替",
                "buildingCode": 1,
                "floorCode": 2,
                "roomCode": 203,
                "lockCode": "1.2.203",
                "isVisible": 1,
				"roomState":1
            }
        ],
        "listSum": 13,
        "totalPages": 2
    }
}

响应参数说明

参数名层级类型条件描述备注
subRoomName2String套房号A-Z大写
roomState2int房间状态1 闲置
2.出租
3.预定
4.到期
5.打扫
6.维护
7封房
V2.1.0版本新增
isVisible2int是否显示到房态图1表示显示,0表示不显示
onlineStatue2int关联的网关状态,3表示在线,4表示离线,为空表示未关联网关1.5.4版本增加
aesKey2String门锁AES128密钥通过AES加密
adminAuthCode2String管理员鉴权码通过AES加密,有权限调用所有蓝牙接口
generalAuthCode2String普通用户鉴权码通过AES加密,没有OTA升级和删除蓝牙锁这2个接口权限,其它蓝牙接口都有权限。
tempAuthCode2String临时鉴权码通过AES加密,与普通授用户权码一样,没有OTA升级和删除蓝牙锁这2个接口权限,其它蓝牙接口都有权限。