描述

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

请求说明

请求方式：POST + application/json

请求路径：https://${填入所在云的域名}/cgi/user/list?thirdTraceId=${随机字符串}

请求头填写 ：参考公共参数填写

请求参数

参数	类型	是否必填	说明
includeNull	Boolean	否	是否包含 null 字段,false:不返回,true:返回，不传默认为false
departmentId	Int	是	部门ID
fetchChild	Boolean	是	如果为true，则同时获取其所有子部门员工; 如果为false或者不传，则只获取当前部门员工
showDepartmentIdsDetail	Boolean	是	如果为true，则会返回员工主属部门(mainDepartmentId)与附属部门(attachingDepartmentIds)

请求示例

{
  "includeNull": true,
  "departmentId": 1,
  "showDepartmentIdsDetail": false,
  "fetchChild": false
}

返回参数

参数	类型	说明
userList	List	成员信息列表
traceId	string	请求唯一ID
errorDescription	string	错误描述
errorMessage	string	错误信息
errorCode	Int	查看错误码

返回示例

{
  "userList": [
    {
      "openUserId": "FSUID_294CDxxxxxxx",
      "account": "111",
      "name": "小明",
      "nickName": "小明",
      "isStop": false,
      "email": "xiaoming@qq.com",
      "mobile": "15611110000",
      "gender": "M",
      "position": "销管",
      "profileImageUrl": "",
      "departmentIds": [111111, 1001, 0000],
      "qq": "",
      "weixin": "",
      "employeeNumber": "111",
      "hireDate": "2023-03-16",
      "birthDate": "",
      "startWorkDate": "",
      "createTime": 1758789217451,
      "leaderId": "FSUID_64121xxxxxxx"
    },
    {
      "openUserId": "FSUID_D1EA4xxxxxxx",
      "account": "112",
      "name": "小红",
      "nickName": "小红",
      "isStop": false,
      "email": "xiaohong@qq.com",
      "mobile": "13711110000",
      "gender": "M",
      "position": "业务员",
      "profileImageUrl": "",
      "departmentIds": [111111, 1001, 0000],
      "qq": "",
      "weixin": "",
      "employeeNumber": "112",
      "hireDate": "2023-03-16",
      "birthDate": "",
      "startWorkDate": "",
      "createTime": 1757488133344,
      "leaderId": "FSUID_92E68xxxxxxxx"
    }
  ],
  "traceId": "E-O.827xxxxxx",
  "errorCode": 0,
  "errorMessage": "success",
  "errorDescription": "成功"
}

注意事项

• 不能使用返回值的message字段做逻辑判断，errorMessage会有变化；