（递归）获取部门成员接口

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

接口版本：

接口版本	更新时间	版本说明
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/user/list

**请求地址：**https://api.jiandaoyun.com/api/v5/corp/department/user/list

**请求频率：**10 次/秒

请求方式：POST

请求参数：

参数	类型	是否必需	说明
dept_no	Number	是	部门编号
has_child	Boolean	否	是否递归获取所有成员。默认为 false，即只获取当前部门下的成员，而不获取其子部门的成员。

请求示例：

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

响应内容：

参数	含义
users	当前指定部门下的成员列表

单个成员的返回数据结构：

参数	含义	备注
name	昵称	name 可以重复，重名成员的name相同
username	用户名	username 在企业内是唯一的，不同企业之间可能存在重复
departments	用户所属的部门编号列表
type	部门类型	0: 常规部门2: 企业互联外部部门
status	部门状态	1: 使用中的部门-1: 集成模式下同步后删除的部门
integrate_id	集成模式同步部门关联 ID	仅在集成模式下返回，且在企业互联接口(外部对接人)不返回

响应示例：

{
  "users": [
    {
      "username": "aubrey",
      "name": "aubrey",
      "departments": [1],
      "type": 0,
      "status": 1
    }
  ]
}

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json

dept_no

number

部门编号

必需

has_child

boolean

可选

是否递归获取所有成员。默认为 false，即只获取当前部门下的成员，而不获取其子部门的成员。

示例

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

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

users

array [object {6}]

必需

name

string

昵称

可选

name 可以重复，重名成员的name相同

username

string

用户名

可选

username 在企业内是唯一的，不同企业之间可能存在重复

departments

array[number]

用户所属的部门编号列表

可选

type

number

部门类型

可选

0: 常规部门 2: 企业互联外部部门

status

number

部门状态

可选

1: 使用中的部门 -1: 集成模式下同步后删除的部门

integrate_id

string

集成模式同步部门关联 ID

必需

在集成模式下返回，且在企业互联接口(外部对接人)不返回

示例

{
    "users": [
        {
            "username": "aubrey",
            "name": "aubrey",
            "departments": [
                1
            ],
            "type": 0,
            "status": 1
        }
    ]
}

（递归）获取部门成员接口