更新假期规则

接口调用量说明钉钉标准版接口累计可调用次数为1万次/月，当前接口会消耗调用次数。若该调用量无法满足需求，你可升级钉钉专业版(Open API调用量50万次/月)或钉钉专属版(Open API调用量500万次/月)扩容调用次数。

调用本接口，更新指定假期的相关规则。

接口适用范围

创建假期规则有2种方式，通过调用接口创建、通过钉钉官方应用考勤产品创建：

创建假期规则方式	调用本接口是否支持更新假期类型
调用添加假期规则接口创建的假期类型。企业内部应用，调用添加假期规则创建。第三方企业应用，调用添加假期规则创建。	支持
企业管理后台考勤应用创建的假期类型。考勤应用系统默认创建。通过考勤应用后台创建。	不支持

如下图所示，在考勤应用 > 假期管理 > 假期规则页面，可以查看共4个假期规则。

接口添加的假期1、接口添加的假期2，是通过接口创建的假期类型。调用本接口，可以更新假期相关的信息，如请假名称、请假单位、计算请假时长方式、余额范围等。

事假、调休，是考勤应用系统默认创建的假期类型。调用本接口，无法更新假期类型，报以下错误信息：errcode:880015,errmsg:批量leaveCode或userId都不存在。

说明

查询哪些假期规则是通过调用接口创建的，可调用查询假期类型列表接口获取：

企业内部应用，调用查询假期规则列表接口查询。

第三方企业应用，调用查询假期规则列表接口查询。

权限

要调用此API，需要以下权限之一。

应用类型	是否支持	权限	API Explorer调试
企业内部应用	支持	钉钉假期管理的权限	API Explorer
第三方企业应用	支持	钉钉假期管理的权限	API Explorer
第三方个人应用	暂不支持	钉钉假期管理的权限	暂不支持

错误码

HttpCode	错误码	错误信息	说明
400	lieuLeaveValidityIncorrect	调休假有效期不正确	调休假有效期不正确
400	bizTypeCannotModified	假期业务类型不能修改	假期业务类型不能修改
400	lieuLeaveOnlyOne	加班调休全局只能有一个	加班调休全局只能有一个
400	bizTypeIncorrect	假期业务类型不正确	假期业务类型不正确
400	unitIncorrect	假期单位不正确	假期单位不正确
400	nameTooLong	假期名称过长	假期名称过长
400	nameAlreadyExists	已存在相同假期名称	已存在相同假期名称
400	leaveOrgIsUsed	只允许企业接入使用	只允许企业接入使用
400	notPermission	无访问权限	无访问权限
400	notManage	部门的管理员不存在	部门的管理员不存在
400	notFound	未找到该假期类型	未找到该假期类型
400	notUpdateType	假期业务类型不能修改	假期业务类型不能修改
400	tryAgainLater	更新失败，请稍后重试	更新失败，请稍后重试
400	updateSpeedfast	亲，该操作速度过快，请5分钟后再试	亲，该操作速度过快，请5分钟后再试
400	systemError	系统错误	系统错误
400	invalidParam	参数错误	参数错误

curl --location --request PUT 'https://api.dingtalk.com/v1.0/attendance/leaves/types?opUserId=String' \ --header 'x-acs-dingtalk-access-token;' \ --header 'Content-Type: application/json' \ --data-raw '{ "leaveName" : "String", "leaveViewUnit" : "String", "bizType" : "String", "naturalDayLeave" : Boolean, "hoursInPerDay" : Long, "leaveCode" : "String", "extras" : "String", "visibilityRules" : [ { "visible" : [ "String" ], "type" : "String" } ], "submitTimeRule" : { "timeValue" : Long, "timeUnit" : "String", "timeType" : "String", "enableTimeLimit" : Boolean }, "leaveCertificate" : { "unit" : "String", "duration" : Double, "enable" : Boolean, "promptInformation" : "String" } }'

{ "result": { "leaveName": "string", "leaveCode": "string", "leaveViewUnit": "string", "bizType": "string", "naturalDayLeave": true, "hoursInPerDay": 0, "visibilityRules": [ { "visible": [ "string" ], "type": "string" } ], "submitTimeRule": { "timeValue": 0, "timeUnit": "string", "timeType": "string", "enableTimeLimit": true }, "leaveCertificate": { "unit": "string", "duration": 0, "enable": true, "promptInformation": "string" } } }

接口适用范围

权限

错误码

请求参数

返回响应

更新假期规则

接口适用范围#

权限#

错误码#

请求参数

返回响应

接口适用范围

权限

错误码