Skip to content

批量查询会议室层级详情

该接口可以使用会议室层级 ID 批量查询会议室层级详情。

请求

项目
HTTP URLhttps://open.feishu.cn/open-apis/vc/v1/room_levels/mget
HTTP MethodPOST
接口频率限制1000 次/分钟、50 次/秒
支持的应用类型custom,isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 开启任一权限即可vc:room 更新视频会议室信息 vc:room:readonly 获取视频会议室信息

请求头

名称类型必填描述
Authorizationstringtenant_access_token 值格式:"Bearer access_token" 示例值:"Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多:如何选择与获取 access token
Content-Typestring固定值:"application/json; charset=utf-8"

请求体

名称类型必填描述
level_idsstring\[\]层级ID列表
示例值:["omb_4ad1a2c7a2fbc5fc9570f38456931293"]

请求体示例

json
{
    "level_ids": [
        "omb_4ad1a2c7a2fbc5fc9570f38456931293"
    ]
}

响应

响应体

名称类型描述
codeint错误码,非 0 表示失败
msgstring错误描述
data\--
  └ itemsroom_level\[\]会议室层级列表
    └ room_level_idstring层级ID
    └ namestring层级名称
    └ parent_idstring父层级ID
    └ pathstring\[\]层级路径
    └ has_childboolean是否有子层级
    └ custom_group_idstring自定义层级ID

响应体示例

json
{
    "code": 0,
    "msg": "success",
    "data": {
        "items": [
            {
                "room_level_id": "层级ID",
                "name": "测试层级",
                "parent_id": "omb_4ad1a2c7a2fbc5fc9570f38456931293",
                "path": [
                    "omb_4ad1a2c7a2fbc5fc9570f38456931293"
                ],
                "has_child": false,
                "custom_group_id": "10000"
            }
        ]
    }
}

错误码

HTTP状态码错误码描述排查建议
500121001internal error服务器内部错误,如果重试无效可联系管理员
400121002not support暂不支持该功能
400121003param error参数错误,检查参数的取值范围(请按照上面字段说明自查)
404121004data not exist请求的数据不存在
404121005no permission无权限进行该操作,建议检查token类型、操作者身份以及资源的归属
404121006data conflict通常由于CAS机制导致,可在更新数据后重试

内容来源:飞书开放平台 · 自动爬取整理