删除序列
调用该接口删除指定序列。
使用限制
仅支持删除没有子序列的序列。如果序列内存在子序列,则不能直接删除。
请求
| 项目 | 值 |
|---|---|
| HTTP URL | https://open.feishu.cn/open-apis/contact/v3/job_families/:job_family_id |
| HTTP Method | DELETE |
| 接口频率限制 | 10 次/秒 |
| 支持的应用类型 | custom |
| 权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 开启任一权限即可 | contact:contact 更新通讯录 contact:job_family 创建、删除、更新租户的工作序列 |
请求头
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| Authorization | string | 是 | tenant_access_token 值格式:"Bearer access_token" 示例值:"Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多:如何选择与获取 access token |
路径参数
| 名称 | 类型 | 描述 |
|---|---|---|
job_family_id | string | 序列 ID。获取方式: - 创建序列时可以从返回结果中获取(job_family_id)。 - 调用获取租户序列列表接口获取序列 ID。 示例值:"mga5oa8ayjlp9rb" |
响应
响应体
| 名称 | 类型 | 描述 |
|---|---|---|
code | int | 错误码,非 0 表示失败 |
msg | string | 错误描述 |
data | \- | - |
响应体示例
json
{
"code": 0,
"msg": "success",
"data": {}
}错误码
| HTTP状态码 | 错误码 | 描述 | 排查建议 |
|---|---|---|---|
| 400 | 42411 | job family has child can not delete | 当前序列下存在子序列,不能删除。你需要先删除子序列。 |
| 400 | 42403 | job family tenant lock fail | 并发更新序列受限,请等待一段时间重试。 |
| 404 | 42402 | job family not exist | 序列不存在。你需要检查并传入正确的序列 ID。 |
更多错误码信息,参见通用错误码。
