获取企业假期管理配置

企业可通过审批应用或自建应用Secret调用本接口,获取可见范围内员工的“假期管理”配置,包括:各个假期的id、名称、请假单位、时长计算方式、发放规则等。
第三方应用可获取应用可见范围内员工的“假期管理”配置,包括:各个假期的id、名称、请假单位、时长计算方式、发放规则等。

请求方式:GET(HTTPS)

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

参数说明:

参数 必须 说明
access_token 调用接口凭证。必须使用审批应用或企业内自建应用的secret获取,获取方式参考:文档-获取access_token

返回结果:

{
    "errcode": 0,
    "errmsg": "ok",
    "lists": [
        {
            "id": 1,
            "name": "年假",
            "time_attr": 0,
            "duration_type": 0,
            "quota_attr": {
                "type": 2,
                "autoreset_time": 0,
                "autoreset_duration": 0
            },
            "perday_duration": 86400
        },
        {
            "id": 2,
            "name": "事假",
            "time_attr": 0,
            "duration_type": 0,
            "quota_attr": {
                "type": 2,
                "autoreset_time": 0,
                "autoreset_duration": 0
            },
            "perday_duration": 86400
        },
        {
            "id": 3,
            "name": "病假",
            "time_attr": 0,
            "duration_type": 0,
            "quota_attr": {
                "type": 2,
                "autoreset_time": 0,
                "autoreset_duration": 0
            },
            "perday_duration": 86400
        }
    ]
}

参数说明:

参数 类型 说明
errcode int32 错误码,详情见错误码说明
errmsg string 错误码对应的错误信息提示
lists obj[] 假期列表
lists.id uint32 假期id
lists.name string 假期名称
lists.time_attr uint32 假期时间刻度:0-按天请假;1-按小时请假
lists.duration_type uint32 时长计算类型:0-自然日;1-工作日
lists.quota_attr obj 假期发放相关配置
lists.quota_attr.type uint32 假期发放类型:0-不限额;1-自动发放;2-手动发放
lists.quota_attr.autoreset_time uint32 自动发放时间戳,若假期发放为自动发放,此参数代表自动发放日期。注:返回时间戳的年份是无意义的,请只使用返回时间的月和日
lists.quota_attr.autoreset_duration uint32 自动发放时长,单位为秒
lists.perday_duration uint32 单位换算值,即1天对应的秒数,可将此值除以3600得到一天对应的小时。

接口频率限制 600次/分钟

错误说明:

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