根据用户名查询假期额度接口
- 接口:/common/absenceAccountQuota/findByUserName
- Method:POST
- 数据格式:JSON
- 限流信息:150次每天和50次每小时
- 多语言环境:在接口请求头中添加Key为locale,Value值为语言环境,目前支持的语言有zh_CN(中文)、en_US(英文)、ja_JP(日文)、zh_TW(
繁体),请选取其中一种
- 接口说明:该接口用作假期额度信息的批量查询,传入的时间是范围,会返回指定用户,在此时间范围内的,指定的假期类型额度
参数:
请求参数
| 字段名称 |
字段类型 |
字段描述 |
是否必填 |
长度限制(字节) |
| bizId |
String |
当前次接口查询的唯一标识 |
TRUE |
36 |
| timestamp |
long |
时间戳 |
TRUE |
13 |
| page_num |
Integer |
分页页数 (默认1,最小1) |
false |
|
| page_size |
Integer |
分页条数 (默认50) |
false |
|
| user_names |
List |
用户名集合 |
TRUE |
无 |
| start_datetime |
long |
开始日期,0时区时间戳,精确到天 |
TRUE |
无 |
| end_datetime |
long |
结束日期,0时区时间戳,精确到天 |
TRUE |
无 |
| absence_code |
String |
假期类型代码 |
TRUE |
100 |
| absence_account_code |
String |
假期额度类型代码 |
TRUE |
100 |
返回参数
| 字段名称 |
字段类型 |
字段描述 |
| resCode |
Integer |
状态码 |
| resMsg |
String |
描述 |
| data |
Object |
返回数据 |
| data.page_info.user_name |
String |
用户名 |
| data.page_info.start_datetime |
long |
开始日期 |
| data.page_info.end_datetime |
long |
结束日期 |
| data.page_info.absence_code |
String |
假期类型代码 |
| data.page_info.absence_name |
String |
假期类型名称 |
| data.page_info.enabled_flag |
String |
是否被启用(Y/N) |
| data.page_info.absence_unit |
String |
请假单位(天 / 小时) |
| data.page_info.absence_mode |
String |
计算方式 |
| data.page_info.absence_account_code |
String |
假期额度类型代码 |
| data.page_info.absence_account_name |
String |
假期额度类型名称 |
| data.page_info.link_absence_code |
String |
前序假期类型代码 |
| data.page_info.link_absence_name |
String |
前序假期类型名称 |
| data.page_info.total |
BigDecimal |
额度 |
| data.page_info.used |
BigDecimal |
已使用 |
| data.page_info.remaining |
BigDecimal |
剩余额度(额度 - 已使用) |
示例:
请求数据
{
"user_names": [
"test@cloudpense.com"
],
"start_datetime": 1735689600000,
"end_datetime": 1767139200000,
"absence_code": "劳务公司年假001",
"absence_account_code": "劳务公司法定年假001",
"bizId": "550e8400-e29b-41d4-a716-446655441234",
"page_size": 20,
"page_num": 1,
"timestamp": 1764914354000
}
返回数据
{
"resCode": 200000,
"resMsg": "success",
"data": {
"page_size": 20,
"page_num": 1,
"total_count": 1,
"total_page": 1,
"is_first_page": true,
"is_last_page": true,
"page_info": [
{
"user_name": "test@cloudpense.com",
"start_datetime": 1735689600000,
"end_datetime": 1767139200000,
"absence_code": "劳务公司年假001",
"absence_name": "劳务公司年假001",
"enabled_flag": "Y",
"absence_account_code": "劳务公司法定年假001",
"absence_account_name": "劳务公司法定年假001",
"absence_unit": "day",
"absence_mode": "work",
"total": 5.000,
"used": 0.000,
"remaining": 5.000,
"link_absence_code": "劳务公司特殊假001",
"link_absence_name": "劳务公司特殊假001"
}
]
}
}