组织成员列表

模板

全局

全局说明

用户

组织

群组

组织成员列表

请求说明

GET http://[SERVER:9022]/v1/org/employees_by_dept?access_token={access_token}&org_id={org_id}&dept_id={dept_id}&include_sub_dept={include_sub_dept}

请求参数：

字段	类型	是否必填	说明
access_token	string	Y	认证的token
org_id	string	Y	组织id
dept_id	string	Y	部门id
include_sub_dept	boolean	N	是否包含下级部门成员 true：包含（默认） false：不包含

返回结果示例

{
  "code": 0, 
  "msg": "ok",
   "data":[
     {
      "org": "companyA",
      "org_id":"1000000",
      "account_id": "200200021", // 员工工号
      "account": "kiso1k1", //账号
      "nick_name": "13610117012",
      "status": "1",
      "mobile_prefix":"86",
      "phone": "13610117012",
      "email": "13610117012@qq.com",
      "gender": 1,
      "avatar":"http://...",
      "reg_time":"2024-12-12 15:53:07",
      "position":"$position_1",
      "dept_detail": [
                {
                    "dept_id": "1",
                    "dept_name": "xxx",
                    "is_dept_head":true
                },
                {
                    "dept_id": "2",
                    "dept_name": "xxx",
                    "is_dept_head":false
                }
            ]
        },
       {
         ....
       }
     
    ]
}

结果字段说明：

参数	类型	说明
data		用户列表
org	string	组织名称
org_id	string	组织id
account_id	string	用户id
account	string	用户账号
nick_name	string	昵称
status	int	"1":正常，“2”：禁用，“3”：离职
mobile_prefix	int	手机号码前缀：86
phone	string	手机号码
email	string	邮箱
gender	int	性别，"1":男，“2”：女
avatar	string	用户头像地址
reg_time	date	注册时间 yyyy-MM-dd HH:mm:ss
position	string	职务id
dept_detail		所在部门内的详细信息

dept_detail说明：

参数	类型	说明
dept_id	string	部门id
dept_name	string	部门名称
is_dept_head	boolean	是否为部门（组织）负责人 true：是 false：否

状态码说明

code	message	说明
100040	Invalid params	参数错误
其他通用错误码