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