（递归）获取部门列表接口 - 简道云

（递归）获取部门列表接口调试

1. 简介

1.1 接口简介

能够（递归）获取指定部门 id 的所有子部门。支持公共模式和集成模式。

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 次每秒提升至 10 次每秒；参数 dept_no 放入 body，接口路由修改为 POST corp/department/list
v6	2022.08.01	部门实体结构中，新增响应参数 seq，支持对部门进行排序

2. 接口调用

能够（递归）获取指定部门 id 的所有子部门。支持公共模式和集成模式。

请求地址：https://api.jiandaoyun.com/api/v6/corp/department/list

请求频率：10 次/秒

请求方式：POST

请求参数：

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

请求示例：

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

{
  "dept_no": 1,
  "has_child": true
}

响应内容：

参数	类型	说明
departments	Array	当前指定部门下的子部门列表，值结构同部门实体结构

响应示例：

{
  "departments": [
    {
      "dept_no": 3,
      "name": "销售部",
      "parent_no": 1,
      "type": 0,
      "status": 1
    },
    {
      "dept_no": 33,
      "name": "华东区销售小组",
      "parent_no": 3,
      "type": 0,
      "status": 1,
      "seq": 2
    }
  ]
}