第三方应用开发 服务端API OA 审批 获取成员假期余额
获取成员假期余额

企业可通过审批应用或自建应用Secret调用本接口,获取可见范围内各个员工的假期余额数据。
第三方应用可获取应用可见范围内各个员工的假期余额数据。

请求方式: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

 

权限说明:
审批应用可获取所有成员的假期余额,自建应用仅可获取自建应用可见范围内成员的假期余额。

返回结果:

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

参数说明:

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

错误说明:

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