修改部门接口调试

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
  }
}

文档内容是否对您有帮助?
有帮助
没帮助没帮助
如需获取即时帮助,请联系技术支持
咨询
扫码领取100+零代码资料简道云官方微信号400-111-0890
图标在线咨询
立即体验