获取建筑物列表

GET https://open.feishu.cn/open-apis/meeting_room/building/list

Reference

  1. 参考接口 获取建筑物列表

Success Response Sample

{
    "code": 0,
    "msg": "success",
    "data": {
        "buildings": [
            {
                "building_id": "omb_ba9da79110bf66329bd14ed1ca1e5c72",
                "country_id": "1784130",
                "description": "",
                "district_id": "109875312",
                "floors": [
                    "F1",
                    "F2",
                    "F3",
                    "F4"
                ],
                "name": "新测试建筑"
            },
            {
                "building_id": "omb_1437739401b436d655336113d951d424",
                "country_id": "1784130",
                "description": "",
                "district_id": "109875312",
                "name": "新测试建筑1"
            },
            {
                "building_id": "omb_afc89d43b377043037c1dc3cd80dc37c",
                "country_id": "1814991",
                "description": "",
                "district_id": "20344371",
                "floors": [
                    "F1",
                    "F2",
                    "F3",
                    "F4"
                ],
                "name": "测试建筑"
            }
        ],
        "has_more": false
    }
}

Request Params

KeyDatatypeRequiredDescription
page_sizenumber请求期望返回的建筑物数量,不足则返回全部,该值默认为 10,最大为 100
page_tokennumber用于标记当前请求的分页标记,将返回以当前分页标记开始,往后 page_size 个元素
order_bystring提供用于对名称进行升序/降序排序的方式查询,可选项有:"name-asc,name-desc",传入其他字符串不做处理,默认无序
fieldsstring用于指定返回的字段名,每个字段名之间用逗号 "," 分隔,如:“id,name”,"*" 表示返回全部字段,可选字段有:"id,name,description,floors",默认返回所有字段

HEADERS

KeyDatatypeRequiredDescription
Authorizationstringtenant_access_token
值格式:"Bearer access_token"

示例值:"Bearer t-7f1bcd13fc57d46bac21793a18e560" | | Content-Type | string | | 固定值:"application/json; charset=utf-8" |

RESPONSES

status: OK

{"code":0,"msg":"success","data":{"buildings":[{"building_id":"omb_e0ab4c89f8d2903816abb5bc3986303b","country_id":"1814991","description":"","district_id":"1790645","floors":["F1","F2","F3","F4"],"name":"hwl新测试建筑"}],"has_more":false}}