同步绩效角色员工信息
接口说明:同步绩效角色员工信息(员工不存在就添加,已存在就更新)
请求方式: POST(HTTPS)
请求地址:https://api.xinrenxinshi.com/v5/apprisal/kpi/roleEmp/save
请求Header:
key | value |
---|---|
access_token | 获取的access_token的实际值 |
Query参数:
key | value |
---|---|
sign | 签名值 |
Body参数:
参数 | 参数类型 | 必传(Y/N) | 说明 |
---|---|---|---|
timestamp | Long | Y | 请求时间戳(精确到毫秒) |
roleId | String | Y | 角色id |
kpiRoleEmpList | List<kpiRoleEmpModel> | Y | 该角色下的员工信息列表,一次最多传5000人 |
kpiRoleEmpModel
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
employeeId | String | Y | 员工id |
manageScopeList | List<KpiRoleEmpManageScopeModel> | N | 该员工管理范围,一次最多500 |
KpiRoleEmpManageScopeModel
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
manageScopeType | IntegerType | Y | 1-部门 2-员工 |
manageScopeId | String | Y | 部门id或者员工id |
返回结果:
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
errcode | Integer | Y | 0成功,其他失败 |
errmsg | String | Y | 结果描述 |
请求示例(HTTPS):
https://api.xinrenxinshi.com/v5/apprisal/kpi/roleEmp/save?sign=26dAzTk%2BzeMz%2Bx45d8SRniM1PTk%3D
请求Body示例:
{
"timestamp": 1606183503814,
"roleId": "a539ea04b36d4eeea28345e9877916ca",
"kpiRoleEmpList": [
{
"employeeId": "a42c11aed7b645a2be77cd0a54cc33da",
"manageScopeList": [
{
"manageScopeType": 2,
"manageScopeId": "437761723efc43f48aa3aa72c1e6720f"
}
]
}
]
}
SDK请求示例(java):
ApprisalkpiSaveRoleEmpRequest request = new ApprisalkpiSaveRoleEmpRequest(access_token());
request.setRoleId("a539ea04b36d4eeea28345e9877916ca");
//填入员工列表
List<ApprisalKpiRoleEmployeeModel> employeeModels = new ArrayList<>();
ApprisalKpiRoleEmployeeModel employeeModel = new ApprisalKpiRoleEmployeeModel();
employeeModel.setEmployeeId("a42c11aed7b645a2be77cd0a54cc33da");
List<ApprisalRoleEmpManageScopeModel> manageScopeList = new ArrayList<>();
//填入管理范围
ApprisalRoleEmpManageScopeModel manageScopeModel = new ApprisalRoleEmpManageScopeModel();
manageScopeModel.setManageScopeId("437761723efc43f48aa3aa72c1e6720f");
manageScopeModel.setManageScopeType(2);
manageScopeList.add(manageScopeModel);
employeeModel.setManageScopeList(manageScopeList);
employeeModels.add(employeeModel);
request.setKpiRoleEmpList(employeeModels);
XrxsApprisalService.saveKpiRoleEmpList(request);
响应实例:
{
"errcode": 0,
"errmsg": "成功"
}