员工列表查询
说明
该接口用于获取该企业的员工，可通过此接口拿到员工的基础信息。
接口限制
1. 10次/秒;
2. 分页查询接口
接口地址
/api/openapi/employee/basic/information/v2
请求类型
POST
请求参数
参数说明
| 参数名称 |
类型 |
是否必填 |
参数说明 |
| pageNo |
int |
否 |
要查询数据的页码，从1开始计数，默认值1。 |
| pageSize |
int |
否 |
每页条数。默认50条，最大值100条。 |
| updateTime |
long |
否 |
更新时间（开始时间）
结束时间默认为当前时间戳 |
参数样例
{
"pageNo":1,
"pageSize":50,
"updateTime":1681267462000
}
响应参数
参数说明
| 参数名称 |
类型 |
说明 |
| list |
List<SimpleEmployee> |
员工信息，包含所属传入部门的部门编码及子部门编码 |
| hasNextPage |
boolean |
是否还有下一页 |
SimpleEmployee
| 参数名称 |
类型 |
说明 |
| employeeId |
String |
员工工号 |
| employeeName |
String |
员工姓名 |
| email |
String |
邮箱 |
| phoneNo |
String |
手机号码 |
| status |
String |
DISABLE离职，ENABLE在职 |
| updatedBy |
long |
更新时间的时间戳 |
| i18nName |
I18nName.md |
员工多语言名称。key 为语言代码（如 ja、ko、zh-TW），value 为对应语言的部门名称。仅返回系统已启用的语言，未启用的语言不返回。已启用但未维护的语言返回空字符串 |
参数样例
{
"code": "ACK",
"message": "",
"data": {
"list": [
{
"employeeId": "206",
"employeeName": "吴**",
"email": "",
"phoneNo": "178********",
"status": "ENABLE",
"i18nName": {
"ja": "jaName",
"zh-TW": "",
"ko": "",
"fr": "",
"es": "",
"pt": "",
"vi": "",
"th": "",
"id": "",
"ru": "",
"hu": "",
"et": ""
}
},
{
"employeeId": "210",
"employeeName": "盛**",
"email": "",
"phoneNo": "188********",
"status": "ENABLE",
"i18nName": {
"ja": "jaName",
"zh-TW": "",
"ko": "",
"fr": "",
"es": "",
"pt": "",
"vi": "",
"th": "",
"id": "",
"ru": "",
"hu": "",
"et": ""
}
}
],
"hasNextPage": false
},
"errorCode": null,
"success": true
}
修改记录
2023-08-03 初始化
2026-07-10 增加 i18nName 字段