获取员工假期余额
接口说明:获取员工的假期余额,只能获取开启了假期余额的假期
请求方式:POST(HTTPS)
请求地址:https://api.xinrenxinshi.com/v5/workflow/holiday/off
请求Header:
key | value |
---|---|
access_token | 获取的access_token的实际值 |
Query参数:
key | value |
---|---|
sign | 签名值 |
Body参数:
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
employeeId | String | Y | 员工id |
endDate | String | Y | 截止日期,格式为yyyy-MM-dd |
timestamp | Long | Y | 请求时间戳(精确到毫秒) |
返回结果:
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
errcode | Integer | Y | 0成功,其他失败 |
errmsg | String | Y | 操作结果描述 |
data | List<holidayRemainResult> | N | 处理成功时的数据结果 |
holidayRemainResult
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
holidayType | Integer | Y | 请假类型 |
holidayName | String | Y | 假期名称 |
plusDay | Double | Y | 假期总余额,按天 |
startTime | String | N | 假期开始时间 格式:yyyy-MM-dd |
endTime | String | N | 假期结束时间 格式:yyyy-MM-dd |
leaveDays | List<HolidayLeaveDayResult> | N | 假期明细 |
HolidayLeaveDayResult
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
leaveDay | Double | Y | 假期余额,按天 |
expiredTime | String | Y | 过期时间 格式:yyyy-MM-dd |
请求示例(HTTPS):
https://api.xinrenxinshi.com/v5/workflow/holiday/off?sign=7omyqoNIY5QPWKCyQM3Q7Hk8mNQ=
请求Body示例:
{
"employeeId": "a42c11aed7b645a2be77cd0a54cc33da",
"endDate": "2022-12-30",
"timestamp": 1606297914820
}
SDK请求示例(java):
FlowHolidayOffDDayRequest request = new FlowHolidayOffDDayRequest(access_token());
request.setEmployeeId("a42c11aed7b645a2be77cd0a54cc33da");
request.setEndDate("2022-12-30");
OpenapiResponse<List<FlowHolidayOffResult>> response = XrxsApprovalService.getHolidayOffDays(request);
响应示例:
{
"errcode":0,
"errmsg":"成功",
"data":[
{
"holidayType":1,
"holidayName":"年假",
"startTime":null,
"endTime":"2022/12/31",
"plusDay":0,
"leaveDays":null
},
{
"holidayType":11,
"holidayName":"调休",
"startTime":null,
"endTime":null,
"plusDay":0,
"leaveDays":null
}
]
}