员工查询
- 接口:/employee?offset={offset}&limit={limit}
- Method:GET
请求参数
参数 | 类型 | 必须 | 默认值 | 描述 |
---|---|---|---|---|
offset | int | Y | 0 | 分页起始 |
limit | int | Y | 500 | 分页条数 |
start | date | N | 根据员工的修改时间,返回start(包括)之后的数据 | |
end | date | N | 根据员工的修改时间, 返回end(不包括)之前的数据 | |
employeeId | string | N | 根据员工工号查询数据 |
#
- start, end的格式为yyyy-MM-dd
- 如果不提供start和end, 则默认取全部的数据
- 接口最多返回500条记录;可通过offset, limit进行分页
- 结果集根据创建时间升序排列
返回数据
参数 | 类型 | 描述 |
---|---|---|
userCode | string | 员工编号(内码) |
mobile | string | 手机号码 |
string | 邮箱 | |
name | string | 员工姓名 |
employeeId | string | 员工工号 |
rank | string | 员工职级名称 |
position | string | 员工职务编码 |
status | string | 员工在职状态, 在职(ENABLE) 离职(DISABLE) |
defaultSubsidiaryBizCode | string | 员工默认业务实体 |
defaultDepartmentBizCode | string | 员工默认部门 |
hireDate | date | 员工入职时间 |
tag | string | 属性 |
residenceCode | string | 常驻地 |
custField1 | string | 自定义字段1 |
custField2 | string | 自定义字段2 |
custField3 | string | 自定义字段3 |
custField.. | string | 自定义字段.. |
note | string | 备注 |
departments | array | 部门信息包含 departmentBizCode(部门编码)、positionBizCode(职务编码)、managerId(部门内上级工号)、employeeId(员工工号)、cover(是否承担部门) |
firstName | string | 名 |
middleName | string | 多为非中国人填写使用 |
lastName | string | 姓 |
identityCardNo | string | 身份证号码 |