获取通道列表
https://api.orbitaiot.com/open/v1/hotel/passWayList
1. HTTP请求方法及示例
| POST /open/v1/hotel/passWayList Host: api.orbitaiot.com Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiIzMCIsImp0aSI6IjA3ODk2NjQzZWNjNzkzYzBjN2M2MjZlYzdkZmNkM........... Content-Type: application/json { "name": "3 building gate"} |
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": 39,
"buildingId": 24,
"floorId": 0,
"roomSysType": 2,
"roomType": 2,
"roomTypeName": "Building",
"name": "3 building gate",
"createDate": "2025-09-30 15:40:56",
"updateDate": "2025-09-30 15:40:56",
"buildingName": "3",
"batteryAlarm": 0,
"lockList": [
{ "id": 8845,
"tid": 7872,
"mac": "0c3d5e964a48",
"bleVersion": "",
"softwareVersion": "v1.1.3.1",
"hardwareVersion": "v84.47",
"electric": "100",
"roomKindName": "",
"gatewayId": 0
}
],
"powerSwitchList": []
}
]
}
}
4. 接口示例

