部门管理


POST /api/v2/department/{ dept_no }/department_list - (递归)获取部门列表

能够(递归)获取指定部门id的所有子部门。

请求参数:

参数 必需 类型 说明
has_child Boolean 是否递归获取所有子部门。默认为false,即只获取一级子部门

请求数据样例:

递归获取当前企业的根部门下所有部门列表。 注:数字1根部门编号

POST /api/v2/department/1/department_list

{
    "has_child": true
}

响应内容:

参数 类型 说明
departments array 当前指定部门下的子部门列表
departments[].dept_no number 部门编号
departments[].name string 部门名称
departments[].parent_no number 父部门编号

响应数据样例:

{
  "departments": [
    {
      "dept_no": 3,
      "name": "销售部",
      "parent_no": 1 //表示父部门编号
    }, {
      "dept_no": 33,
      "name": "华东区销售小组",
      "parent_no": 3
    }
  ]
}

POST /api/v2/department/create - 创建部门

请求参数:

参数 必需 类型 说明
name string 部门名称
parent_no number 父部门编号,不传默认为根部门
dept_no number 部门编号,不传自动生成(上限 9007199254740991)

请求数据样例:

{
    "name": "研发部门",
    "parent_no": 1,
    "dept_no": 2
}

响应内容:

参数 类型 说明
department json 创建的部门信息
department.dept_no number 部门编号
department.name string 部门名称
department.parent_no number 父部门编号

响应数据样例:

{
  "department": {
    "dept_no": 2,
    "name": "研发部门",
    "parent_no": 1
  }
}

POST /api/v2/department/{ dept_no }/update - 修改部门

请求参数:

参数 必需 类型 说明
name string 部门名称

请求数据样例:

{
    "name": "测试部门"
}

响应内容:

参数 类型 说明
department json 创建的部门信息
department.dept_no number 部门编号
department.name string 部门名称
department.parent_no number 父部门编号

响应数据样例:

{
  "department": {
    "dept_no": 3,
    "name": "测试部门",
    "parent_no": 2
  }
}

POST /api/v2/department/{ dept_no }/delete - 删除部门

请求参数:

响应内容:

参数 类型 说明
status string 返回请求结果

响应数据样例:

{
    "status": "success"
}
本文是否对您有帮助?
 有帮助
 没帮助
您是否遇到了以下问题?
如需获取即时帮助,请联系技术支持