# 获取会议室列表

该接口用于获取指定建筑下的会议室。

## 请求

基本 |  
---|---
HTTP URL | https://open.feishu.cn/open-apis/meeting_room/room/list?building_id=omb_8ec170b937536a5d87c23b418b83f9bb&page_size=1&page_token=0&order_by=name-asc&fields=*
HTTP Method | GET
支持的应用类型 | Custom App、Store App
权限要求<br>**调用该 API 所需的权限。开启其中任意一项权限即可调用** | 获取会议室信息(calendar:room:readonly)

### 请求头

名称 | 类型 | 必填 | 描述
---|---|---|---
Authorization | string | 是 | `tenant_access_token`<br>**值格式**："Bearer `access_token`"<br>**示例值**："Bearer t-7f1bcd13fc57d46bac21793a18e560"<br>[了解更多：如何选择与获取 access token](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-choose-which-type-of-token-to-use)
Content-Type | string | 是 | **固定值**："application/json; charset=utf-8"

### 查询参数

| **参数**    | **参数类型** | **必须** | **说明**                                                     |
| ----------- | ------------ | -------- | ------------------------------------------------------------ |
| building_id | string       | 是       | 被查询的建筑物 ID                                            |
| page_size   | int          | 否       | 请求期望返回的会议室数量，不足则返回全部，该值默认为 100，最大为 1000 |
| page_token  | string       | 否       | 用于标记当前请求的分页标记，将返回以当前分页标记开始，往后 page_size 个元素 |
| order_by    | string       | 否       | 提供用于对名称/楼层进行升序/降序排序的方式查询，可选项有："name-asc,name-desc,floor_name-asc,floor_name-desc"，传入其他字符串不做处理，默认无序 |
| fields      | string       | 否       | 用于指定返回的字段名，每个字段名之间用逗号 "," 分隔，如：“id,name”，"*" 表示返回全部字段，可选字段有："id,name,description,capacity,building_id,building_name,floor_name,is_disabled,display_id"，默认返回所有字段 |

## 响应

### 响应体

| **参数**       | **说明**                                                     |
| -------------- | ------------------------------------------------------------ |
| code           | 返回码，非 0 表示失败                                        |
| msg            | 返回码的描述，"success" 表示成功，其他为错误提示信息         |
| data           | 返回业务信息                                                 |
| ∟page_token    | 分页标记，存在下一页时返回                                   |
| ∟has_more      | 存在下一页时，该值为 true，否则为 false                      |
| ∟rooms         | 会议室列表                                                   |
| &nbsp;&nbsp;&nbsp;∟room_id       | 会议室 ID                                                    |
| &nbsp;&nbsp;&nbsp;∟building_id   | 会议室所属建筑物 ID                                          |
| &nbsp;&nbsp;&nbsp;∟building_name | 会议室所属建筑物名称                                         |
| &nbsp;&nbsp;&nbsp;∟capacity      | 会议室能容纳的人数                                           |
| &nbsp;&nbsp;&nbsp;∟description   | 会议室的相关描述                                             |
| &nbsp;&nbsp;&nbsp;∟display_id    | 会议室的展示 ID                                              |
| &nbsp;&nbsp;&nbsp;∟floor_name    | 会议室所在楼层名称                                           |
| &nbsp;&nbsp;&nbsp;∟is_disabled   | 会议室是否不可用，若会议室不可用，则该值为 true，否则为 false |
| &nbsp;&nbsp;&nbsp;∟name          | 会议室名称                                                   |

### 响应体示例

```json
{
    "code":0,
    "msg":"success",
    "data":{
        "page_token":"1",
        "has_more":true,
        "rooms":[
            {
                "room_id":"omm_eada1d61a550955240c28757e7dec3af",
                "building_id":"omb_8ec170b937536a5d87c23b418b83f9bb",
                "building_name":"Building name",
                "capacity":14,
                "description":"Some description",
                "display_id":"FM537532166",
                "floor_name":"F1",
                "is_disabled":false,
                "name":"Room name"
            }
        ]
    }
}
```

### 错误码

具体可参考：[服务端错误码说明](https://open.feishu.cn/document/ukTMukTMukTM/ugjM14COyUjL4ITN)