dingtalk.oapi.attendance.vacation.quota.list (查询假期余额)

根据企业或员工分页获取假期余额信息 每次返回50条数据

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
leave_code String 必须 f84a2829-d245-4312-9ff2-0653e5b3abb2 假期类型唯一标识
op_userid String 必须 zhangsan 操作者ID
userids String [] 必须 zhangsan,lisi
  • 最大列表长度:50
  • 待查询的员工ID列表
    offset Number 必须 0
  • 最小值:0
  • 分页偏移(从0开始非负整数)
    size Number 必须 10
  • 最大值:200
  • 分页偏移(正整数 最大200)

    响应参数

    名称 类型 示例值 描述
    result OapiLeaveQuotaUserListVo 结果值
    • └ has_more
    • Boolean
    • false
    • 是否存在更多记录
    • leave_quotas
    • Leavequotas []
    • 假期余额列表
    • └ userid
    • String
    • zhangsan
    • 员工ID
    • └ leave_code
    • String
    • f84a2829-d245-4312-9ff2-0653e5b3abb2
    • 假期类型唯一标识
    • └ quota_cycle
    • String
    • 2019
    • 额度所对应的周期
    • └ quota_id
    • String
    • f84a2829-d245-4312-9ff2-0653e5b3abb2
    • 配额唯一标记
    • └ start_time
    • Number
    • 1653851001000
    • 额度有效期开始时间(毫秒级时间戳)
    • └ end_time
    • Number
    • 1753851001000
    • 额度有效期结束时间(毫秒级时间戳)
    • └ quota_num_per_hour
    • Number
    • 1000
    • 单位以天计算的额度总数(假期类型按天计算该值不为空且按百分之一天折算 例如 1000=10天)
    • └ quota_num_per_day
    • Number
    • 1000
    • 单位以小时计算的额度总数(假期类型按小时计算该值不为空且按百分之一小时折算 例如 1000=10小时)
    • └ used_num_per_day
    • Number
    • 100
    • 单位以天计算的使用额度(假期类型按天计算该值不为空且按百分之一天折算 例如 100=1天)
    • └ used_num_per_hour
    • Number
    • 100
    • 单位以小时计算的使用额度(假期类型按小时计算该值不为空且按百分之一小时折算 例如 100=1小时)
    errcode Number 0 dingOpenErrcode
    errmsg String ok errorMsg
    success Boolean true 是否正确访问

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/attendance/vacation/quota/list");
    OapiAttendanceVacationQuotaListRequest req = new OapiAttendanceVacationQuotaListRequest();
    req.setLeaveCode("f84a2829-d245-4312-9ff2-0653e5b3abb2");
    req.setOpUserid("zhangsan");
    req.setUserids("zhangsan,lisi");
    req.setOffset(0L);
    req.setSize(10L);
    OapiAttendanceVacationQuotaListResponse rsp = client.execute(req, access_token);
    System.out.println(rsp.getBody());

    响应示例

    • JSON示例
    {
        "result":{
            "has_more":false,
            "leave_quotas":[
                {
                        "userid":"zhangsan",
                        "leave_code":"f84a2829-d245-4312-9ff2-0653e5b3abb2",
                        "quota_cycle":"2019",
                        "quota_id":"f84a2829-d245-4312-9ff2-0653e5b3abb2",
                        "start_time":1653851001000,
                        "end_time":1753851001000,
                        "quota_num_per_hour":1000,
                        "quota_num_per_day":1000,
                        "used_num_per_day":100,
                        "used_num_per_hour":100
                }
            ]
        },
        "errcode":0,
        "errmsg":"ok",
        "success":true
    }

    异常示例

    • JSON示例
    {
    	"errcode":88,
    	"errmsg":"ding talk error"
    }

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部