删除会议室层级
该接口可以用来删除某个会议室层级。
请求
| 项目 | 值 |
|---|---|
| HTTP URL | https://open.feishu.cn/open-apis/vc/v1/room_levels/del |
| 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" |
请求体
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
room_level_id | string | 是 | 层级ID 示例值："omb_4ad1a2c7a2fbc5fc9570f38456931293" 数据校验规则： - 长度范围： 1 ～ 100 字符 |
delete_child | boolean | 否 | 是否删除所有子层级 示例值：false |
请求体示例
json
{
"room_level_id": "omb_4ad1a2c7a2fbc5fc9570f38456931293",
"delete_child": false
}响应
响应体
| 名称 | 类型 | 描述 |
|---|---|---|
code | int | 错误码，非 0 表示失败 |
msg | string | 错误描述 |
data | \- | - |
响应体示例
json
{
"code": 0,
"msg": "success",
"data": {}
}错误码
| 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机制导致，可在更新数据后重试 |
| 404 | 125001 | cannot delete child at this level | 尚未升级会议室灵活层级，或者不符合"会议室视图展示方式"，暂不支持在该层级创建/更新会议室，且不支持删除层级时保留子会议室。 |