获取成员假期余额

POST

http://127.0.0.1/cgi-bin/oa/vacation/getuservacationquota

第三方应用开发/OA/审批

最后修改时间：2022-08-30 03:03:37

责任人：未设置

企业可通过审批应用或自建应用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

请求参数

Query 参数

access_token

string

调用接口凭证

必需

示例值:

Body 参数application/json

userid

string

可选

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

示例

{
  "userid": "ZhangSan"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST 'http://127.0.0.1/cgi-bin/oa/vacation/getuservacationquota?access_token={{accesstoken}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "userid": "ZhangSan"
}'

返回响应

🟢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

可选

示例

{
  "errcode": 0,
  "lists": [
    {
      "usedduration": 0,
      "vacationname": "string",
      "id": 0,
      "assignduration": 0,
      "leftduration": 0
    }
  ],
  "errmsg": "string"
}

获取企业假期管理配置

修改成员假期余额