添加假期类型
POST
/topapi/attendance/vacation/type/create说明
调用本接口添加假期类型。
服务地址:https://oapi.dingtalk.com
权限
服务端API是以应用维度授权的,在调用接口前,确保已经为应用添加了接口权限。详情请参考权限申请。
应用类型 | 是否支持调用 | 权限申请方式 | API Explorer调试 |
---|---|---|---|
企业内部应用 | 是 | 开发者后台申请 | 调试 |
第三方企业应用 | 是 | 开发者后台申请 | 调试 |
第三方个人应用 | 否 | — | — |
请求参数
调用服务端API的应用凭证。企业内部应用可通过获取企业内部应用的access_token接口获取。第三方企业应用可通过获取第三方企业应用的access_token接口获取。
请假单位。day:天halfDay:半天hour:小时
假期类型。general_leave:普通假期lieu_leave:加班转调休
是否按照自然日统计请假时长。当为false的时候,用户发起请假时候会根据用户在请假时间段内的排班情况来计算请假时长
当前企业内拥有“OA审批”应用权限的管理员的userid。
每天折算的工作时长,百分之一。例如:1天=10小时=1000。
调休假有效期规则。validity_type:有效类型 absolute_time:绝对时间relative_time:相对时间validity_value:延长日期当validity_type为absolute_time该值该值不为空且满足“yy-mm”格式。当validity_type为relative_time该值为大于1的整数。
限制值。当timeUnit为day时,有效值范围是0至30天;timeUnit为hour时,有效值范围是0至24小时。
时间单位:day:天hour:小时
限制类型:before:提前after:补交
是否开启限时提交功能,仅且为true时开启。
请假证明单位:hour:小时day:天
超过多长时间需提供请假证明。
{
"natural_day_leave": true,
"leave_view_unit": "day",
"hours_in_per_day": 1000,
"leave_name": "年假",
"biz_type": "general_leave",
"extras": "{\"validity_type\":\"absolute_time\",\"validity_value\":\"12-31\"}",
"op_userid": "user01",
"leave_certificate": {
"unit": "hour",
"duration": 1,
"enable": false,
"prompt_information": "请假信息"
},
"submit_time_rule": {
"time_value": 18,
"time_unit": "day",
"time_type": "before",
"enable_time_limit": false
}
}
示例代码
返回响应
请假单位。day:天halfDay:半天hour:小时
请假证明单位:hour:小时day:天
超过多长时间需提供请假证明。
限制值。当timeUnit为day时,有效值范围是0至30天;timeUnit为hour时,有效值范围是0至24小时。
时间单位:day:天hour:小时
限制类型:before:提前after:补交
是否开启限时提交功能,仅且为true时开启。
假期类型。general_leave:普通假期lieu_leave:加班转调休
是否按照自然日统计请假时长。当为false的时候,用户发起请假时候会根据用户在请假时间段内的排班情况来计算请假时长。
每天折算的工作时长,百分之一。例如:1天=10小时=1000。
{
"errcode": 0,
"errmsg": "string",
"success": true,
"result": {
"leave_name": "string",
"leave_code": "string",
"leave_view_unit": "string",
"leave_certificate": {},
"leave_certificate.unit": "string",
"leave_certificate.duration": 0,
"leave_certificate.enable": true,
"leave_certificate.prompt_information": "string",
"submit_time_rule": {},
"submit_time_rule.time_value": 0,
"submit_time_rule.time_unit": "string",
"submit_time_rule.time_type": "string",
"submit_time_rule.enable_time_limit": true,
"biz_type": "string",
"natural_day_leave": true,
"hours_in_per_day": 0
}
}