修改成员假期余额

POST

/cgi-bin/oa/vacation/setoneuserquota

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

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

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'https://qyapi.weixin.qq.com/cgi-bin/oa/vacation/setoneuserquota?access_token=' \
--header 'Content-Type: application/json' \
--data-raw '{"userid":"ZhangSan","vacation_id":1,"leftduration":604800,"time_attr":1,"remarks":"PLACE_HOLDER"}'

响应示例

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

请求参数

Query 参数

access_token

调用接口凭证

必需

示例值:

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字符

示例

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

可选

errmsg

string

可选

修改于 2022-12-07 07:40:06

获取成员假期余额

概述