查询建筑物详情

该接口用于获取指定建筑物的详细信息。

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/meeting_room/building/batch_get?building_ids=omb_8ec170b937536a5d87c23b418b83f9bb&building_ids=omb_38570e4f0fd9ecf15030d3cc8b388f3a&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_ids	array<string>	是	用于查询指定建筑物的 ID
fields	string	否	用于指定返回的字段名，每个字段名之间用逗号 "," 分隔，如：“id,name”，"*" 表示返回全部字段，可选字段有："id,name,description,floors"，默认返回所有字段

响应

响应体

参数	说明
code	返回码，非 0 表示失败
msg	返回码的描述，"success" 表示成功，其他为错误提示信息
data	返回业务信息
∟buildings	建筑列表
∟building_id	建筑物 ID
∟description	建筑物的相关描述
∟floors	属于当前建筑物的所有楼层列表
∟name	建筑物名称
∟country_id	所属国家 ID
∟district_id	所属城市 ID

响应体示例

{
    "code":0,
    "msg":"success",
    "data":{
        "buildings":[
            {
                "building_id":"omb_8ec170b937536a5d87c23b418b83f9bb",
                "description":"Some description",
                "floors":[
                    "F1"
                ],
                "name":"Building name",
                "country_id": "Country id",
                "district_id": "District id"
            },
            {
                "building_id":"omb_38570e4f0fd9ecf15030d3cc8b388f3a",
                "description":"Some description",
                "floors":[
                    "F1",
                    "F2"
                ],
                "name":"Building name_2",
                "country_id": "Country id",
                "district_id": "District id"
            }
        ]
    }
}

错误码

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