创建会议室层级

该接口用于创建会议室层级。

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/vc/v1/room_levels
HTTP Method	POST
接口频率限制	20 次/分钟
支持的应用类型	custom,isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用	vc:room 更新视频会议室信息

请求头

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

请求体

名称	类型	必填	描述
name	string	是	层级名称 示例值："测试层级"
parent_id	string	是	父层级ID。 说明：如需在租户层级（即根层级）下创建会议室层级，可以先调用查询会议室层级详情接口，将路径参数 room_level_id 传入 0 进行查询，返回结果中的 room_level_id 值即为根层级 ID。 示例值："omb_4ad1a2c7a2fbc5fc9570f38456931293"
custom_group_id	string	否	自定义层级ID 示例值："10000"

请求体示例

{
    "name": "测试层级",
    "parent_id": "omb_4ad1a2c7a2fbc5fc9570f38456931293",
    "custom_group_id": "10000"
}

响应

响应体

名称	类型	描述
code	int	错误码，非 0 表示失败
msg	string	错误描述
data	\-	-
└ room_level	room_level	层级详情
└ room_level_id	string	层级ID
└ name	string	层级名称
└ parent_id	string	父层级ID
└ path	string\[\]	层级路径
└ has_child	boolean	是否有子层级
└ custom_group_id	string	自定义层级ID

响应体示例

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

错误码

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