修改部门接口调试
1. 简介
1.1 接口简介
修改指定部门的部门信息。仅支持公共模式。
1.2 接口版本
接口版本 | 更新时间 | 版本说明 |
v1 | 2018.12.4 | 使用 _id 作为 id |
v2 | 2019.6.21 | 使用 dept_no 作为 id |
v4 | 2022.6.30 | 返回值新增字段 type、status、integrate_id |
v5 | 2022.10.28 | 在 v4 的基础上,接口请求频率由 5 次每秒提升至 20 次每秒; 参数 dept_no 放入 body,接口路由修改为 POST corp/department/update |
v6 | 2023.08.01 | 新增请求参数和响应参数seq,支持进行部门排序。 |
2. 接口调用
修改指定部门的部门信息。仅支持公共模式。
请求地址:https://api.jiandaoyun.com/api/v6/corp/department/update
请求频率:20 次/秒
请求方式:POST
请求参数:
参数 | 是否必需 | 类型 | 说明 |
name | 否 | String | 部门名称 |
parent_no | 否 | Integer | 上级部门编号 |
dept_no | 是 | Number | 部门编号 |
seq | 否 | number | 部门排序 |
注:请求参数中的 name 、 parent_no 和 seq 至少填写一个。
请求示例:
{
"dept_no": 3,
"name": "测试部门",
"parent_no": 1,
"seq": 1
}
响应内容:
参数 | 类型 | 说明 |
department | Json | 创建的部门信息 |
department.dept_no | Number | 部门编号 |
department.name | String | 部门名称 |
department.parent_no | Number | 父部门编号 |
type | Number | 部门类型 |
status | Number | 部门状态 |
integrate_id | String | 集成模式同步部门关联 ID,仅在集成模式下返回,且在企业互联接口(外部对接人)不返回 |
seq | number | 部门排序 |
响应示例:
{
"department": {
"dept_no": 3,
"name": "测试部门",
"parent_no": 2,
"type": 0,
"status": 1
"seq": 1
}
}