获取成员假期余额

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

请求方式:POST(HTTPS)

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

请求示例

{
    "userid": "ZhangSan"
}

参数说明:

参数 必须 类型 说明
access_token string 调用接口凭证。必须使用审批应用或企业内自建应用的secret获取,获取方式参考:文档-获取access_token
userid string 需要获取假期余额的成员的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": "病假"
        }
    ]
}

参数说明:

参数 类型 说明
errcode int32 错误码,详情见错误码说明
errmsg string 错误码对应的错误信息提示
lists obj[] 假期列表
lists.id int32 假期id
lists.assignduration uint32 发放时长,单位为秒
lists.usedduration uint32 使用时长,,单位为秒
lists.leftduration uint32 剩余时长,单位为秒
lists.vacationname string 假期名称

接口频率限制 600次/分钟
注:余额的时长单位都为秒,如果假期时间刻度为“按天”,需要除以86400,得到真实假期余额天数;如果假期时间刻度为“按小时”,需要除以3600得到真实假期余额小时数。

错误说明:

错误码 说明
301062 没有假勤权限
301063 参数错误
301064 内部错误
© 1998 - 2021 Tencent Inc. All Rights Reserved