Obtain Guest-Authorized Room List
https://api.orbitaiot.com/open/v1/hotelguest/guestRoomList
1. HTTP Request Method and Example
| 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. Parameter Description
Headers Parameter
| Key | Type | Request | Vlues |
| Content-Type | String | Y | application/json |
| Authorization | String | Y | Bearer [access_token value] |
Body Parameter
| Name | Type | Required | Description |
| mobile | String | N | Mobile phone number. At least one of the mobile phone number or email address is required. |
| String | N | Email address. At least one of the mobile phone number or email address is required. | |
| sys_language_code | String | N | en |
3. Return Parameters and Examples
| Name | Type | Description | |
| code | Int | ||
| message | String | ||
| data | JSONArray |
Objects in the data list
| Name | Type | Description |
| list | JSONArray | |
| listPub | JSONArray | |
| listPassway | JSONArray | |
| minArrivalTime | Int | |
| maxDepartureTime | Int |
Objects in the list
| Name | Type | Description |
| 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 | The following are the objects in the LockListr list |
| id | Int | |
| tid | Int | To search for Bluetooth door locks and connect them, they need to be used; |
| mac | String | Subsequent guests need to transmit the value of this tid to obtain unlocking instructions; |
| 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 |
Objects in the listPub list
| Name | Type | Description |
| id | Int | |
| buildingId | Int | |
| floorId | Int | |
| roomSysType | Int | |
| roomType | Int | |
| roomTypeName | String | |
| name | String | |
| createDate | String | |
| updateDate | String | |
| lockList | JSONArray | The following are the objects in the LockListr list |
| 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 |
Objects in the listPassway list
| id | Int | |
| buildingId | Int | |
| floorId | Int | |
| roomSysType | Int | |
| roomTypeName | String | |
| name | String | |
| createDate | String | |
| updateDate | String | |
| lockList | JSONArray | The following are the objects in the lockList list |
| id | Int | |
| tid | Int | To search for Bluetooth door locks and connect them, they need to be used; |
| mac | String | Subsequent guests need to transmit the value of this tid to obtain unlocking instructions |
| 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 |
{
"code": 0,
"message": "success",
"data": {
"list": [
{
"id": 2,
"buildingId": 1,
"buildingName": "Building 1",
"floorId": 1,
"floorName": "1",
"name": "102",
"roomClass": 1,
"roomClassName": "Standard room",
"roomStatus": 1,
"roomStatusStr": "Fully Occupied",
"isDirty": 0,
"checkinRecordId": 2,
"arrivalTime": 1748497712,
"arrivalTimeStr": "2025-05-29 13:48",
"departureTime": 1834906559,
"departureTimeStr": "2028-02-23 16:15",
"authTime": 1748497712,
"lockList": [
{
"id": 652,
"tid": 151,
"mac": "dc32622b89a5",
"bleVersion": "",
"softwareVersion": "v1.1.1.4",
"hardwareVersion": "v84.2",
"electric": "60",
"roomKindName": "Standard room"
}
]
}
],
"listPub": [],
"listPassway": [],
"minArrivalTime": 1748497712,
"maxDepartureTime": 1834906559
}
}
