获取宾客授权房间列表
https://api.orbitaiot.com/open/v1/hotelguest/guestRoomList
1. HTTP请求方法及示例
| POST /open/v1/hotelguest/guestRoomList Host: api.orbitaiot.com Content-Type: application/json Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiIxMyIsImp0aSI6ImM3NzY3ZWZjYjYwNzI3Zjc0OGU3NGJmM2M3MDJkMzA2NGMzNTMyMDcyZDU1ZDcxNjhmYmFhMzE0YzQ3Njk2YTQ0NTA4ODk2MzZjOTQ5MTAyIiwiaWF0IjoxNzQwMzY4NTY1LCJuYmYiOjE3NDAzNjg1NjUsImV4cCI6MTc0Mjc4Nzc2NSwic3ViIjoiNCIsInNjb3BlcyI6WyIqIl19.q5j0oF9HnFhYwiOXv-COZ4bGVSb6mHrdityhvmZ-ov9LAWNpF7eiAwhea2H3n8mXNBwbeGldgL0RxcpkpNX9JVCGUNxuPibNmCz5Ue3ZgnvR2eFr2JG7DxJ8-ukbZQVGde9kLq3ZDP8uXk4FzwkQlOFTbarWcH6yWNvkrqsUagjCxucAi0WPZjpVbTiVKSIEUYQ6WWP2b_nz9Yzf5Du2qjPLcq2wjU3OlAUY5_5P43Xt-LC4e0y2evsmc81TV4-F62ysFHkJNqzx24Vbtenbz6OPoOWw6AmVD1QgsQVOcgaufm7xY7ZbkOeEQxWVIJelUP0JgzXyHbmxvmFVtZWtT0bDkVECQENV1caqVf9YFDOc2qIqWcuglZZ9MyLrub7ycM8gaJ_TpA9yP6Z8Uo8Na8KJePH0ayO20F3un2cKxHhBtILj62NJGcf-NLAez7wGCCYkCO1-ykYqnALQFG6KJ27Lg_oDosQetVlLemLTx9PGwtE7dqW9QK9kLnk8cl9STyHPNM5wrIvhKaSH3NkQwKphn26rYfRg_f_QAA-pDMkV4mlOEWDqFPuW1kTcYqAU8SoIijROZgi56qU3fzxIzke6-fJX7XdyeGHwrLUaCwVHbBzTn-905LS7Bj7XW5f9DqgB4WkbSTattzWNAHaAKYjTA2P7lHuIbPVliLfCjBk {"sys_language":"zh-CN", "mobile":"13715199290"} |
2. 参数说明
Headers参数
| 字段 | 类型 | 是否必需 | 值 |
| Content-Type | String | 是 | application/json |
| Authorization | String | 是 | Bearer + 空格 + access_token值 |
Body参数
| 名称 | 类型 | 是否必需 | 描述 |
| mobile | String | N | 手机号，手机号跟邮箱至少需要一个 |
| 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 | 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 }}
