Obtain Room List

https://api.orbitaiot.com/open/v1/hotel/hotelRoomList

1. HTTP Request Method and Example

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. 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
name	String	N	Room Name
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 lockList 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	Subsequent employees obtaining the unlocking instruction need to transmit the value of this TID;
mac	String	To search for Bluetooth door locks and connect them, they need to be used;
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": 1,

"buildingId": 1,

"buildingName": "Building 1",

"floorId": 1,

"name": "101",

"floorNumber": "101",

"floorName": "1",

"roomCardId": "0101",

"roomModelId": 1,

"roomClass": 1,

"roomClassName": "Standard room",

"checkin_record_id": 3,

"roomStatus": 1,

"roomStatusStr": "Fully Occupied",

"isDirty": 0,

"roomModelName": "standard",

"roomModelPrice": "288.00",

"createDate": "2025-05-26 15:29:11",

"updateDate": "2025-06-06 15:53:05",

"modelName": "standard",

"modelPrice": "288.00",

"batteryAlarm": 0,

"lockList": [

{

"id": 653,

"tid": 152,

"mac": "3cab72ab0d35",

"bleVersion": "",

"softwareVersion": "v1.1.1.5",

"hardwareVersion": "v84.2",

"electric": "17",

"roomKindName": "Standard room"

}

]

{

"id": 73,

"buildingId": 1,

"buildingName": "Building 1",

"floorId": 6,

"name": "0101",

"floorNumber": "201",

"floorName": "2",

"roomCardId": "0201",

"roomModelId": 1,

"roomClass": 1,

"roomClassName": "Standard room",

"checkin_record_id": 0,

"roomStatus": 0,

"roomStatusStr": "Vacant room",