获取成员假期余额

POST

/cgi-bin/oa/vacation/getuservacationquota

服务端API企业内部开发第三方应用开发

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

权限说明：
审批应用可获取所有成员的假期余额，自建应用仅可获取自建应用可见范围内成员的假期余额。

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

错误说明：

错误码	说明
301062	没有假勤权限
301063	参数错误
301064	内部错误

文档ID: 25691
原文档地址：
https://open.work.weixin.qq.com/api/doc/90000/90135/93376
https://open.work.weixin.qq.com/api/doc/90001/90143/94212

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'https://qyapi.weixin.qq.com/cgi-bin/oa/vacation/getuservacationquota?access_token=' \
--header 'Content-Type: application/json' \
--data-raw '{"userid":"ZhangSan"}'

响应示例

{
  "errcode": 0,
  "errmsg": "ok",
  "lists": [
    {
      "id": 1,
      "assignduration": 0,
      "usedduration": 0,
      "leftduration": 604800,
      "vacationname": "年假",
      "real_assignduration": 0
    },
    {
      "id": 2,
      "assignduration": 1296000,
      "usedduration": 0,
      "leftduration": 1296000,
      "vacationname": "事假",
      "real_assignduration": 1296000
    },
    {
      "id": 3,
      "assignduration": 1296000,
      "usedduration": 0,
      "leftduration": 1296000,
      "vacationname": "病假",
      "real_assignduration": 86400
    }
  ]
}

请求参数

Query 参数

access_token

调用接口凭证

必需

示例值:

Body 参数application/json

userid

string

可选

需要获取假期余额的成员的userid

示例

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

可选

lists

array [object {5}]

假期列表

可选

usedduration

integer <int32>

使用时长，单位为秒

可选

vacationname

string

假期名称

可选

integer <int32>

假期id

可选

assignduration

integer <int32>

发放时长，单位为秒

可选

leftduration

integer <int32>

剩余时长，单位为秒

可选

errmsg

string

可选

修改于 2022-12-05 02:32:41

获取企业假期管理配置

修改成员假期余额