获取会议室列表

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

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/meeting_room/room/list?building_id=omb_8ec170b937536a5d87c23b418b83f9bb&page_size=1&page_token=0ℴ_by=name-asc&fields=*
HTTP Method	GET
支持的应用类型	custom,isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用	calendar:room:readonly 获取会议室信息

请求头

名称	类型	必填	描述
Authorization	string	是	tenant_access_token 值格式："Bearer access_token" 示例值："Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多：如何选择与获取 access token
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	会议室列表
∟room_id	会议室 ID
∟building_id	会议室所属建筑物 ID
∟building_name	会议室所属建筑物名称
∟capacity	会议室能容纳的人数
∟description	会议室的相关描述
∟display_id	会议室的展示 ID
∟floor_name	会议室所在楼层名称
∟is_disabled	会议室是否不可用，若会议室不可用，则该值为 true，否则为 false
∟name	会议室名称

响应体示例

{
    "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"
            }
        ]
    }
}

错误码

具体可参考：服务端错误码说明