员工详情列表
接口说明: 查询员工详细信息的列表。
特殊说明:字段是文件组或图片组类型的情况下，值是文件对象列表转成的json字符串。
fileName:文件名。
fileKey:文件key,可以通过文件下载接口下载文件。
fileUrl:文件下载地址。
请求方式:POST（HTTPS）
请求地址:https://api.xinrenxinshi.com/v5/employee/list
请求Header:
| key | value |
|---|---|
| access_token | 获取的access_token的实际值 |
Query参数:
| key | value |
|---|---|
| sign | 签名值 |
Body参数:
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| departmentId | String | N | 部门ID，不为空时获取指定部门下的员工，为空时默认获取公司全部的员工 |
| pageNo | Integer | Y | 起始页码，默认从0开始，翻页+1 |
| pageSize | Integer | Y | 查询员工数量，单次数量限制100 |
| fetchChild | Integer | Y | 是否包含子部门员工,0不包含,1包含 |
| status | Integer | Y | 员工状态，默认为0。0:在职员工、1:离职员工、2:待入职、8:删除 |
| modtime | Integer | N | 更新时间(精确到秒)，员工详情列表的增量查询。如果传了该参数，则只返回更新时间在查询时间之后的员工数据 |
| timestamp | Long | Y | 请求时间戳（精确到毫秒） |
返回结果:
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| errcode | Integer | Y | 错误码 |
| errmsg | String | Y | 错误信息 |
| data | PageResult | Y | 员工详情信息列表 |
PageResult
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| totalPageSize | Long | Y | 总页数 |
| pageNo | Integer | Y | 当前页 |
| pageSize | Integer | Y | 每页显示条数 |
| result | List<EmployeeDetail> | Y | 员工详情信息，详见:员工详情接口 |
| hasMore | boolean | Y | 是否有下一页 true-有，false-没有 |
特殊说明:员工字段信息里面的“护照号”更名为“证件号”
请求示例(HTTPS):
https://api.xinrenxinshi.com/v5/employee/list?sign=X5O4br3gDtG1wMwSnWCkWe%2BXIgQ%3D
请求Body示例:
{
"pageNo": 0,
"pageSize": 10,
"departmentId": "a54e4cbb3c114fd8b8c0e7d85ee024e7",
"fetchChild": 1,
"status": 0,
"timestamp": 1606198930285
}
SDK请求示例(java):
EmployeeDetailInfoListRequest request = new EmployeeDetailInfoListRequest(access_token);
request.setDepartmentId("a54e4cbb3c114fd8b8c0e7d85ee024e7");
request.setFetchChild(FetchChildEnum.CONTAINS_DEPARTMENT);
request.setPageNo(0);
request.setPageSize(10);
request.setStatus(EmpStatusEnum.ON_JOB);
OpenapiResponse<PageResult<EmployeeDetail>> list = XrxsEmployeeService.getDetailEmployeeList(request);
响应示例:
{
"errcode": 0,
"errmsg": "成功",
"data": {
"totalPageSize": 1,
"pageNo": 0,
"pageSize": 10,
"result": [
{
"employeeId": "04577f3277f841248f17d36e2561f642",
"name": "方旭",
"mobile": "19002393231",
"entryDate": "2019-11-12",
"hireType": 0,
"email": "fangyu@xrxs.com",
"status": 0,
"addtime":1606100590,
"modtime":1606308521,
"dismissionType": 0,
"dismissionReason": "",
"dismissionDate": "",
"secondment":1,//派入
"seconded":0,//派出
"fields": {
"部门": "a54e4cbb3c114fd8b8c0e7d85ee024e7",//部门id
"岗位": "ffe93f52aaf54cd285118667ee2f0d19",//岗位id
"工号": "137764",
"职级": "P100",
"HRBP": "3cfd59661b0642659f12eb8c75ad0f18",//hrbp的员工id
"汇报对象": "3cfd59661b0642659f12eb8c75ad0f18",//汇报对象的员工id
"个人邮箱": "2424399527@qq.com",
"联系手机": "19400131686",
"自我介绍": "自我感觉良好",
"所属国籍": "241",//对应国籍列表信息中的国籍id
"纳税城市": "北京市北京市",
"工作地点": "北京市北京市",
"开户行": "武汉支行",
"直属下属数量": "0",
"司龄": "1.03年",
"试用期截止日": "2020-11-24",
"首次参加工作时间": "2019-11-02",
"有无违法违纪行为": "无",
"居住证截止日期": "2029-12-22",
"银行卡号": "2424399527242439952",
"籍贯": "北京市北京市",
"国家/地区": "中国大陆",
"子女状态": "无",
"招聘渠道": "智联招聘",
"户籍所在地": "北京市北京市",
"婚姻状况": "未婚",
"证件号": "",
"最高学历": "请选择",
"身份证号": "429006202011245416",
"年龄": "1",
"QQ": "2424399527",
"上家公司": "",
"社保电脑号": "2424399527",
"工作城市": "北京市北京市",
"生日": "1124",
"入党时间": "2020-11-24",
"生活照": "md+znJl772zqCBfkOOMBk2IxY2U5YmZiMmYzNWUxYzYyNDYxNTA4N2VhZjMyNWIxNmRiNzlmNzBhZmU4MDJMOZMrKYJG89c5E+sS8e0bugnMQcbCBnGlnzo7GUEVa+7nXT0OFe1xBD/YoqHMRa8==",//对应上传文件返回的文件key
"工龄": "1.34年",
"主动离职主因": "",
"公积金账号": "2424399527",
"自定义选项": "自定义选项",
"转正评价": "",
"通讯地址": "北京省北京市",
"管理形式": "总部",
"被动离职原因": "",
"其他招聘渠道": "暂时没有",
"员工照片": "",
"调整工龄(天)": "100",
"社招/校招": "社招",
"存档机构": "中国政府",
"属相": "鼠",
"民族": "汉",
"自我评价": "",
"转正日期": "2020-11-25",
"办理离职时间": "",
"血型": "O型",
"调整司龄(天)": "0",
"主动离职次因": "",
"星座": "射手座",
"转正状态": "已转正",
"居住证城市": "北京市北京市",
"居住证办理日期": "2019-11-30",
"身份证照": "0BRItoygRfQEyb1Wlwt8YmI1YzZkY2ZkZTAxNjUwYzI4Yjc4MTY5YTE1NDBjZGHwlD3dDeyYLi9+xhL+qXwRPL1F1PBKwyCsRzMez7u5IAMdVqO7xF7O9QwSHRkynnxiagTN/QXMqCWjOSA73td6oLL8nG5A6WKqpEHkw==",//对应上传文件返回的文件key
"现居住地": "北京省北京市",
"英文名": "",
"性别": "男",
"成本中心": "c03b7ef4fced4e64a256327a740b39fc",//成本中心id
"子女有无商业保险": "无",
"证照类型": "中国护照",
"出生日期": "2019-09-14",
"政治面貌": "党员",
"出生国家": "241",
"微信": "19400131686",
"有无重大病史": "无",
"推荐企业/人": "xrxs",
"虚拟部门Id":"c961159ebd244a57a41236cf77a1f3cf,e9025aaa3d214f73bf8691943c8c68f3",
"虚拟部门":"虚拟部门测试、ren",
"自定义字段1": "这是自定义的信息",
"测试文件组":"[{\"fileName\":\"1.png\",\"fileKey\":\"cH830por/GAVkC1xiXpv0zllNGY2NzdmYmRmMzk1YjliMmFjMGYyYjMyMmNlMDhhMjVkOGNlYmQ3ZjFjMzIzMjNjMWMwMjllNWI5OWJiODLwUvYJv5wIpjRCPAbzTIYTpfJIOVLv2MBLBPNa4EyCEIWbP6Nn19LuIyCTHx0IgD4vPYFALzM5P9/cAQ0eaK/12iC10PCOp0K+NU5OHhwN6qYPdMReyfKg2MlO7U7iy6gJvqQQZroZqqDPfikGT+65uTEJSR2FPlc1tjARws5mRQ==\",\"fileUrl\":\"https://f.xinrenxinshi.com/site/download?ptoken=efc4bce763b1142ec97944f4086bb9555e83f562461beaeeb72c4130aef100000.png\"}]"
}
}
],
"hasMore": false
}
}