企业内部开发 服务端API OA 审批 获取企业假期管理配置
获取企业假期管理配置

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

 

请求方式:GET(HTTPS)

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

参数说明:

参数必须说明
access_token调用接口凭证。必须使用第三方应用accesstoken获取,获取方式参考:文档-获取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
        }
    ]
}

参数说明:

参数类型说明
errcodeint32错误码,详情见错误码说明
errmsgstring错误码对应的错误信息提示
listsobj[]假期列表
lists.iduint32假期id
lists.namestring假期名称
lists.time_attruint32假期时间刻度:0-按天请假;1-按小时请假
lists.duration_typeuint32时长计算类型:0-自然日;1-工作日
lists.quota_attrobj假期发放相关配置
lists.quota_attr.typeuint32假期发放类型:0-不限额;1-自动发放;2-手动发放
lists.quota_attr.autoreset_timeuint32自动发放时间戳,若假期发放为自动发放,此参数代表自动发放日期。注:返回时间戳的年份是无意义的,请只使用返回时间的月和日
lists.quota_attr.autoreset_durationuint32自动发放时长,单位为秒
lists.perday_durationuint32单位换算值,即1天对应的秒数,可将此值除以3600得到一天对应的小时。
接口频率限制 600次/分钟

错误说明:

错误码说明
301062没有假勤权限
301063参数错误
301064内部错误
上一篇
获取审批数据(旧)
下一篇
获取成员假期余额