获取员工详情信息
接口说明: 根据员工id获取员工的详细信息(总公司内的员工)。可以通过此接口获取员工的基本信息。
请求方式:POST(HTTPS)
请求地址:https://api.xinrenxinshi.com/v5/employee/head/detail
请求Header:
key | value |
---|---|
access_token | 获取的access_token的实际值 |
Query参数:
key | value |
---|---|
sign | 签名值 |
Body参数:
参数 | 参数类型 | 必传(Y/N) | 说明 |
---|---|---|---|
employeeId | String | Y | 员工id |
status | Integer | N | 员工状态,默认为0。0:在职员工、1:离职员工、2:待入职、8:删除 |
timestamp | Long | Y | 请求时间戳(精确到毫秒) |
返回结果:
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
errcode | Integer | Y | 0成功,其他失败 |
errmsg | String | Y | 结果描述 |
data | EmployeeFixedDetailModel | Y | 员工信息 |
EmployeeFixedDetailModel
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
employeeId | String | Y | 员工ID |
entryDate | String | Y | 入职时间,格式:yyyy-MM-dd |
hireType | Integer | Y | 聘用类型,0-正式,10-实习,11-劳务,12-顾问,13-返聘,14-外包,15-兼职 |
mobile | String | Y | 手机号 |
String | Y | 工作邮箱 | |
name | String | Y | 员工名字 |
gender | Integer | Y | 性别,男-1,女-2 |
status | Integer | Y | 员工状态,0:在职员工、1:离职员工、2:待入职、8:删除 |
addtime | Integer | Y | 添加时间 |
modtime | Integer | Y | 更新时间 |
dismissionType | Integer | N | 离职类型,0:主动离职,1:被动离职,2:退休,3:协商解除,999:其他 |
dismissionReason | String | N | 离职原因 |
dismissionDate | String | N | 离职日期,格式:yyyy-MM-dd |
bankName | String | N | 开户行 |
bankCard | String | N | 银行账号 |
idcode | String | N | 身份证号 |
age | Integer | N | 年龄 |
birthday | String | N | 生日 |
bornDate | String | N | 出生日期 |
directorId | String | N | 汇报对象 |
hrbpId | String | N | hrbp |
companyAge | String | N | 司龄 |
hireType | Integer | N | 正式类型:0-正式,1-非正式 |
laborType | Integer | N | 雇佣类型: 10-实习,11-劳务,12-顾问,13-返聘,14-外包,15-兼职 |
departmentId | String | N | 部门id |
jobId | String | N | 岗位id |
jobName | String | N | 岗位名称 |
rank | String | N | 职级 |
jobNumber | String | N | 工号 |
personalEmail | String | N | 个人邮箱 |
city | String | N | 工作城市 |
nickName | String | N | 昵称 |
workAge | String | N | 工作年龄 |
请求示例(HTTPS):
https://api.xinrenxinshi.com/v5/employee/head/detail?sign=X5O4br3gDtG1wMwSnWCkWe%2BXIgQ%3D
请求Body示例:
{
"employeeId": "3cfd59661b0642659f12eb8c75ad0f18",
"status": 0,
"timestamp": 1606199386843
}
SDK请求示例(java):
EmployeeDetailByHeadRequest request = new EmployeeDetailByHeadRequest(access_token());
request.setEmployeeId("dcb72d5e025f4721a077430178b44516");
request.setStatus(0);
OpenapiResponse<EmployeeFixedDetailModel> response = XrxsEmployeeService.getDetailEmployeeByHead(request);
响应示例:
{
"errcode":0,
"errmsg":"成功",
"data":{
"employeeId":"dcb72d5e025f4721a077430178b44516",
"name":"测试1",
"email":"safssafawfa@qq.com",
"mobile":"19424141545",
"gender":1,
"bankName":"招商银行",
"bankCard":"6243213213123",
"idcode":"xxxxxxxxxx",
"age":24,
"birthday":"0522",
"bornDate":"2023-05-22",
"status":0,
"addtime":1666923649,
"modtime":1684830291,
"directorId":"4da26b57f3a1423aac42e4171668cd81",
"hrbpId":"aeb637942646450082f94d2a53bd7751",
"entryDate":"2022-10-28",
"companyAge":"0.56年",
"hireType":0,
"laborType":10,
"departmentId":"8c2a7186b1c74adeb94cf6495ad1dc55",
"workAge":"0.0年",
"dismissionDate":null,
"dismissionType":0,
"dismissionReason":"",
"jobId":"",
"jobName":"",
"rank":"",
"jobNumber":"KS001",
"personalEmail":"",
"city":2,
"nickName":"测试"
}
}