修改成员假期余额

POST

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

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

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

责任人：未设置

企业可通过审批应用或自建应用Secret调用本接口，修改可见范围内员工的“假期余额”。
第三方应用可通过应本接口修改应用可见范围内指定员工的“假期余额”。

注：余额的时长单位都为秒，如果假期时间刻度为“按天”，需要除以86400，得到真实假期余额天数；如果假期时间刻度为“按小时”，需要除以3600得到真实假期余额小时数。

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

接口频率限制 600次/分钟

错误说明：

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

文档ID: 25692
原文档地址：
https://open.work.weixin.qq.com/api/doc/90000/90135/93377
https://open.work.weixin.qq.com/api/doc/90001/90143/94213

请求参数

Query 参数

access_token

string

调用接口凭证

必需

示例值:

Body 参数application/json

time_attr

integer <int32>

必需

假期时间刻度：0-按天请假；1-按小时请假主要用于校验，必须等于企业假期管理配置中设置的假期时间刻度类型

vacation_id

integer <int32>

假期id

必需

userid

string

必需

需要修改假期余额的成员的userid

leftduration

integer <int32>

必需

设置的假期余额,单位为秒不能大于1000天或24000小时，当假期时间刻度为按小时请假时，必须为360整倍数，即0.1小时整倍数，按天请假时，必须为8640整倍数，即0.1天整倍数

remarks

string

可选

修改备注，用于显示在假期余额的修改记录当中，可对修改行为作说明，不超过200字符

示例

{
  "userid": "ZhangSan",
  "vacation_id": 1,
  "leftduration": 604800,
  "time_attr": 1,
  "remarks": "PLACE_HOLDER"
}

示例代码

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/setoneuserquota?access_token={{accesstoken}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "userid": "ZhangSan",
    "vacation_id": 1,
    "leftduration": 604800,
    "time_attr": 1,
    "remarks": "PLACE_HOLDER"
}'

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

可选

errmsg

string

可选

示例

{
  "errcode": 0,
  "errmsg": "string"
}

获取成员假期余额

复制/更新模板到企业