企业可通过审批应用或自建应用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
}
]
}
参数说明:
参数 | 类型 | 说明 |
---|---|---|
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 | 内部错误 |