根据用户名查询假期额度接口

  • 接口:/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"
      }
    ]
  }
}

results matching ""

    No results matching ""