获取房间列表
https://api.orbitaiot.com/open/v1/hotel/hotelRoomList
1. HTTP请求方法及示例
| POST /open/v1/hotel/hotelRoomList Host: api.orbitaiot.com Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiIyMCIsImp0aSI6IjIyNjA4YTdkNmJlN2E2NGQ0NmQzMDg5M2MzYjNhODA1NDQwMjY wN2EzNTg0YmJkZWYxZDdkMTZlNTcxMmE3YTBhMGEyOTQwODAzMmYxMzY5IiwiaWF0IjoxNzUxNTEzNjMzLCJuYmYiOjE3NTE1MTM2MzMsImV4cCI6MTc1OTQ2Mj QzMywic3ViIjoiMTEiLCJzY29wZXMiOlsiKiJdfQ.1wWneISJipHqI3YjhYkoTWbIJ7RaRS5LqKdLWzHewfC5pBAq8TmafQ5locnynEQC197XJQ564wxf3DqxXSIcigXFeTOj 8ZDMyxBYJMpuY2ZG3qMyUp9KBN8jz8yKpK6kQDmPzW-nTLE7dsAbRdOOgd4pSXJ5b539wLL31KiZHuJxo30MNjsUAKmIVcPBGm59vOKSoQ494QHtED--3ulOaPO w_Fw3ZvhqQVwrDfiMn_6cRW2K69d3Ry54bz7o4boOX4fIH_p6NsO7PlMPWDeP7yce94SRl_bGnYvgVtnldXLwXKTg3A6bAA5TUHqXGPbtA3IVURzWfl7m-U09t2biNB IP80Yp-KUxWj1meLyhlrjXvkwsBqg_FRYkTmOeS8-Fl2J4CcedygR6al7TYUyUkbEiAYIN1LmftLP-2VE3EHvrDZeWY0lkJFMqxO1psnm-lZPV4vPYpDbQpZ3QfYtZ7huOE wFzEPjw1IJPoZ2Zcv6aSmOkKzi6ExYY-KcbyLLUH8B2uP-TnsQbwa5RqZ6glzVrCBY05v_Ju8SKkEXEEL0qhATZ5LVmtddKK126T-4if7K7aUQTuH8rbIyQWalxTNYVDVR cBPAb6Qdy8jjuY5ihgiwtpwqvrh_PxfO_bwJRhAbPvhR6ALo1Fe3MNMzqKdVndaZ0MRSwR6rHIOFq2MA Content-Type: application/json Postman-Token: be57e4ab-ff93-460e-8b46-249d40867636 { "name": "0101"}- |
2. 参数说明
Headers参数
| 字段 | 类型 | 是否必需 | 值 |
| Content-Type | String | 是 | application/json |
| Authorization | String | 是 | Bearer + 空格 + access_token值 |
Body参数
| 名称 | 类型 | 是否必需 | 描述 |
| name | String | N | 筛选条件，房名 |
| Sys_language | String | N | 语言 |
3. 返回参数及示例
| 参数 | 类型 | 描述 | |
| code | Int | ||
| message | String | ||
| data | JSONArray |
data列表中的对象
| 参数 | 类型 | 描述 |
| list | JSONArray | |
| listPub | JSONArray | |
| listPassway | JSONArray | |
| minArrivalTime | Int | |
| maxDepartureTime | Int |
list列表中的对象
| 参数 | 类型 | 描述 |
| id | Int | |
| buildingId | Int | |
| floorId | Int | |
| name | String | |
| floorNumber | String | |
| roomCardId | String | |
| roomModelId | Int | |
| roomClassName | String | |
| roomStatus | Int | |
| roomStatusStr | String | |
| isDirty | Int | |
| createDate | String | |
| updateDate | String | |
| hotelId | Int | |
| buildingName | String | |
| floorName | String | |
| checkingRecordId | Int | |
| arrival_time | Int | |
| arrival_timeStr | String | |
| departure_time | Int | |
| departure_timeStr | String | |
| auth_time | Int | |
| LockList | JSONArray | 下面是LockListr列表中的对象 |
| id | Int | |
| tid | Int | 后续员工获取开锁指令需要传这个tid的值； |
| mac | String | 后续搜索、连接蓝牙设备需要使用； |
| product_type | Int | |
| dev_group | Int | |
| is_bind | Int | |
| dev_type | Int | |
| mesh_id | Int | |
| ble_version | String | |
| software_version | String | |
| harware_version | String | |
| electric | String | |
| door_alarm | Int | |
| room_type | Int | |
| mesh_enable | Int | |
| mes_addr | Int | |
| roomKindName | String |
listPub列表中的对象
| 参数 | 类型 | 描述 |
| id | Int | |
| buildingId | Int | |
| floorId | Int | |
| roomSysType | Int | |
| roomType | Int | |
| roomTypeName | String | |
| name | String | |
| createDate | String | |
| updateDate | String | |
| lockList | JSONArray | 以下是lockList列表中的对象 |
| id | Int | |
| tid | Int | |
| mac | String | |
| product_type | Int | |
| dev_group | Int | |
| is_bind | Int | |
| dev_type | Int | |
| mesh_id | Int | |
| ble_version | String | |
| software_version | String | |
| hardware_version | String | |
| electric | String | |
| door_alarm | Int | |
| room_type | Int |
listPassway列表中的对象
| id | Int | |
| buildingId | Int | |
| floorId | Int | |
| roomSysType | Int | |
| roomTypeName | String | |
| name | String | |
| createDate | String | |
| updateDate | String | |
| lockList | JSONArray | 以下是lockList列表中的对象 |
| id | Int | 后续员工获取开锁指令需要传这个tid的值； |
| tid | Int | 后续搜索、连接蓝牙设备需要使用； |
| mac | String | |
| product_type | Int | |
| dev_group | Int | |
| is_bind | Int | |
| dev_type | Int | |
| mesh_id | Int | |
| ble_version | String | |
| software_version | String | |
| hardware_version | String | |
| electric | String | |
| door_alarm | Int | |
| room_type | Int |
注意：1.获取门锁的tid，后续员工获取开锁指令需要传这个tid的值；
2.获取门锁的mac,后续搜索、连接蓝牙设备需要使用；
{ "code": 0,
"message": "成功",
"data": {
"list": [ {
"id": 405,
"buildingId": 94,
"floorId": 577,
"name": "402",
"floorNumber": "402",
"roomCardId": "0402",
"roomModelId": 8,
"roomClass": 2,
"roomClassName": "套房",
"roomStatus": 1,
"roomStatusStr": "已住满",
"isDirty": 0,
"createDate": "2024-11-13 10:11:59",
"updateDate": "2025-01-14 10:04:54",
"hotelId": 32,
"buildingName": "1栋",
"floorName": "4",
"checkinRecordId": 252,
"arrival_time": 1733450539,
"arrival_timeStr": "2024-12-06 10:02",
"departure_time": 1891317600,
"departure_timeStr": "2029-12-07 14:00",
"auth_time": 0,
"lockList": [ {
"id": 257,
"tid": 47,
"mac": "c13932353c12",
"product_type": 0,
"dev_group": 1,
"is_bind": 1,
"dev_type": 52,
"mesh_id": 0,
"ble_version": "",
"software_version": "v3.26.22.0",
"hardware_version": "v1.0",
"electric": "79",
"door_alarm": 0,
"room_type": 14,
"mesh_enable": 0,
"mesh_addr": 0,
"roomKindName": "套房A房" }
]
} ],
"listPub": [ {
"id": 76,
"buildingId": 0,
"floorId": 0,
"roomSysType": 4,
"roomType": 5,
"roomTypeName": "公共房1",
"name": "vip1",
"createDate": "2024-12-11 15:40:32",
"updateDate": "2024-12-11 15:40:32",
"lockList": [ {
"id": 445,
"tid": 90,
"mac": "d1393235345a",
"product_type": 0,
"dev_group": 1,
"is_bind": 1,
"dev_type": 52,
"mesh_id": 0,
"ble_version": "",
"software_version": "v3.26.22.0",
"hardware_version": "v1.0",
"electric": "94",
"door_alarm": 0,
"room_type": 5
} ]
} ],
"listPassway": [ {
"id": 62,
"buildingId": 0,
"floorId": 0,
"roomSysType": 2,
"roomType": 1,
"roomTypeName": "通道大门",
"name": "酒店大门",
"createDate": "2024-11-23 17:21:59",
"updateDate": "2024-11-23 17:21:59",
"lockList": [ {
"id": 403,
"tid": 23,
"mac": "c53832343242",
"product_type": 0,
"dev_group": 1,
"is_bind": 1,
"dev_type": 52,
"mesh_id": 0,
"ble_version": "",
"software_version": "v3.26.21.0",
"hardware_version": "v1.0",
"electric": "64",
"door_alarm": 0,
"room_type": 1
} ] }
],
"minArrivalTime": 1733450539,
"maxDepartureTime": 1891317600 }}
