Obtain Door Access List
https://api.orbitaiot.com/open/v1/hotel/passWayList
1. HTTP Request Method and Example
| POST /open/v1/hotel/passWayList Host: api.orbitaiot.com Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiIzMCIsImp0aSI6IjA3ODk2NjQzZWNjNzkzYzBjN2M2MjZlYzdkZmNkM........... Content-Type: application/json { "name": "3 building gate"} |
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 | Door Access Name |
3. Return Parameters and Examples
| Name | Type | Description | |
| code | Int | ||
| message | String | ||
| data | JSONArray |
Objects in the data list
| Name | Type | Description |
| list | JSONArray |
Objects in the list
| Name | Type | Description |
| id | Int | |
| buildingId | Int | |
| floorId | Int | |
| name | String | |
| floorNumber | String | |
| roomCardId | String | |
| createDate | String | |
| updateDate | String | |
| 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; |
| ble_version | String | |
| software_version | String | |
| harware_version | String | |
| electric | String |
{ "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. Interface Example
