第三方应用开发 服务端API 审批 获取成员假期余额
获取成员假期余额
最后更新:2023/12/01
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
获取成员假期余额
最后更新:2023/12/01

通过本接口可获取应用可见范围内各个员工的假期余额数据。

请求方式:POST(HTTPS)

请求地址:https://qyapi.weixin.qq.com/cgi-bin/oa/vacation/getuservacationquota?access_token=ACCESS_TOKEN

请求示例

{
    "userid": "ZhangSan"
}

参数说明:

参数必须类型说明
access_tokenstring调用接口凭证。必须使用第三方应用accesstoken获取,获取方式参考:文档-获取access_token
useridstring需要获取假期余额的成员的userid

权限说明:

应用类型权限要求
自建应用配置到「审批 - 可调用接口的应用」中
代开发应用具有「审批」权限
第三方应用具有「审批」权限
1.第三方应用可以获取第三方应用添加的模板详情。
2.自建应用的Secret可获取企业自建模板的模板详情。
3.接口调用频率限制为600次/分钟。

注: 从2023年12月1日0点起,不再支持通过系统应用secret调用接口,存量企业暂不受影响 查看详情

返回结果:

{
    "errcode": 0,
    "errmsg": "ok",
    "lists": [
        {
            "id": 1,
            "assignduration": 0,
            "usedduration": 0,
            "leftduration": 604800,
            "vacationname": "年假",
			"real_assignduration": 0
        },
        {
            "id": 2,
            "assignduration": 1296000,
            "usedduration": 0,
            "leftduration": 1296000,
            "vacationname": "事假",
			"real_assignduration": 1296000
        },
        {
            "id": 3,
            "assignduration": 1296000,
            "usedduration": 0,
            "leftduration": 1296000,
            "vacationname": "病假",
			"real_assignduration": 86400
        }
    ]
}

参数说明:

参数类型说明
errcodeint32错误码,详情见错误码说明
errmsgstring错误码对应的错误信息提示
listsobj[]假期列表
lists.idint32假期id
lists.assigndurationuint32发放时长,单位为秒
lists.useddurationuint32使用时长,单位为秒
lists.leftdurationuint32剩余时长,单位为秒
lists.vacationnamestring假期名称
lists.real_assigndurationuint32假期的实际发放时长,通常在设置了按照实际工作时间发放假期后进行计算
接口频率限制 600次/分钟
注:余额的时长单位都为秒,如果假期时间刻度为“按天”,需要除以86400,得到真实假期余额天数;如果假期时间刻度为“按小时”,需要除以3600得到真实假期余额小时数。

错误说明:

错误码说明
301062没有假勤权限
301063参数错误
301064内部错误
上一篇
获取企业假期管理配置
下一篇
修改成员假期余额