登录
第三方应用开发 服务端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
}
]
}参数说明：
| 参数 | 类型 | 说明 |
|---|---|---|
| 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 | 内部错误 |
- 获取企业假期管理配置
本节内容
