获取部门下成员信息(详细)

curl --location --request POST 'https://open.fxiaoke.com/cgi/user/list' \ --header 'Content-Type: application/json' \ --data-raw '{ "corpAccessToken": "CORP_ACCESS_TOKEN", "corpId": "CORP_ID", "departmentId": "DEPARTMENT_ID", "fetchChild": false }'

{ "userlist": [ { "openUserId": "FSUID_XXXXXXXXXXXXXXXXXX", "account": "13252412555", "name": "Andson", "nickName": "Andy", "isStop": false, "email": "test@test.com", "mobile": "13252412555", "gender": "M", "position": "PM", "profileImageUrl": "201502_09_99aa47b5-1f3d-4473-8c02-3d69a6769e57", "departmentIds": [ 18, 19 ], "employeeNumber": "168XXX002", "hireDate": "2015/08/31", "birthDate": "1990/09/25", "startWorkDate": "2010-08-31", "createTime": 1504547315500, "leaderId": "FSUID_XXXXXXXXXXXXXXXXXX" }, { "openUserId": "FSUID_XXXXXXXXXXXXXXXXXXXXXX", "account": "Samuel", "name": "Samuel", "nickName": "Sam", "isStop": false, "email": "test01@test.com", "mobile": "12333232123", "gender": "M", "position": "Engineer", "profileImageUrl": "201505_04_8e903c78-077a-4ead-97f8-417ca599dd75", "departmentIds": [ 10, 20 ], "employeeNumber": "168XXX002", "hireDate": "2016/08/31", "birthDate": "1989/09/05", "startWorkDate": "2008-08-31", "createTime": 1504547315500, "leaderId": "FSUID_XXXXXXXXXXXXXXXXXX" } ], "errorCode": 0, "errorMessage": "success" }

请求参数

Body 参数application/json

corpAccessToken

string

必需

企业应用访问公司合法性凭证

corpId

string

必需

开放平台公司帐号

departmentId

string

必需

部门ID, 为非负整数

fetchChild

boolean

可选

如果为true，则同时获取其所有子部门员工; 如果为false或者不传，则只获取当前部门员工

showDepartmentIdsDetail

string

可选

如果为true，则会返回员工主属部门(mainDepartmentId)与附属部门(attachingDepartmentIds)

示例

返回响应

🟢200成功

application/json

Body

userlist

array[object (userlist ) {19}]

成员列表

可选

openUserId

string

开放平台员工帐号

可选

account

string

员工账号

可选

name

string

员工姓名

可选

nickName

string

员工昵称

可选

isStop

boolean

可选

员工状态，如果为true,则表示此员工离职，否则，该员工状态为在职

string

邮箱

可选

mobile

string

手机号

可选

gender

string

可选

员工性别：M(男) F(女)

position

string

员工职位

可选

profileImageUrl

string

头像文件ID

可选

departmentIds

array[integer]

可选

员工所属部门及其父部门ID列表

mainDepartmentId

string

员工主属部门ID

可选

attachingDepartmentIds

string

可选

员工附属部门ID列表

employeeNumber

string

员工编号

可选

hireDate

string

入职日期

可选

birthDate

string

员工生日

可选

startWorkDate

string

参加工作日期

可选

createTime

integer

创建时间

可选

leaderId

string

汇报对象

可选

errorCode

integer

返回码

必需

errorMessage

string

必需

对返回码的文本描述内容

🟢200错误