获取公共房列表
https://api.orbitaiot.com/open/v1/hotel/pubRoomList
1. HTTP请求方法及示例
| POST /open/v1/hotel/pubRoomList Host: api.orbitaiot.com Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiIzMCIsImp0aSI6IjA3ODk2NjQzZWNjNzkzYzBjN2M2...... { "name": "test room"} |
2. 参数说明
Headers参数
| 字段 | 类型 | 是否必需 | 值 |
| Content-Type | String | 是 | application/json |
| Authorization | String | 是 | Bearer + 空格 + access_token值 |
Body参数
| 名称 | 类型 | 是否必需 | 描述 |
| name | String | N | 筛选条件，通道名称 |
3. 返回参数及示例
| 参数 | 类型 | 描述 | |
| code | Int | ||
| message | String | ||
| data | JSONArray |
data列表中的对象
| 参数 | 类型 | 描述 |
| list | JSONArray |
list列表中的对象
| 参数 | 类型 | 描述 |
| id | Int | |
| buildingId | Int | |
| floorId | Int | |
| name | String | |
| floorNumber | String | |
| roomCardId | String | |
| createDate | String | |
| updateDate | String | |
| LockList | JSONArray | 下面是LockListr列表中的对象 |
| id | Int | |
| tid | Int | 后续员工获取开锁指令需要传这个tid的值； |
| mac | String | 后续搜索、连接蓝牙设备需要使用； |
| ble_version | String | |
| software_version | String | |
| harware_version | String | |
| electric | String |
注意： 1.获取门锁的tid，后续员工获取开锁指令需要传这个tid的值；
2.获取门锁的mac,后续搜索、连接蓝牙设备需要使用；
{
"code": 0,
"message": "success",
"data": {
"list": [
{
"id": 32,
"buildingId": 0,
"floorId": 0,
"roomSysType": 4,
"roomType": 5,
"roomTypeName": "Public room 1",
"name": "test room",
"createDate": "2025-08-13 10:43:14",
"updateDate": "2026-06-02 14:40:07",
"batteryAlarm": 0,
"lockList": [
{
"id": 926,
"tid": 415,
"mac": "3cab72ab0d80",
"bleVersion": "",
"softwareVersion": "v1.1.25.1",
"hardwareVersion": "v84.43",
"electric": "100",
"roomKindName": "",
"gatewayId": 0
}
],
"powerSwitchList": [ ]
}
]
}
}
4. 接口示例
