添加假期类型

说明

调用本接口添加假期类型。
服务地址：https://oapi.dingtalk.com

权限

服务端API是以应用维度授权的，在调用接口前，确保已经为应用添加了接口权限。详情请参考权限申请。

应用类型	是否支持调用	权限申请方式	API Explorer调试
企业内部应用	是	开发者后台申请	调试
第三方企业应用	是	开发者后台申请	调试
第三方个人应用	否	—	—

请求参数

Query 参数

access_token

string

必需

调用服务端API的应用凭证。企业内部应用可通过获取企业内部应用的access_token接口获取。第三方企业应用可通过获取第三方企业应用的access_token接口获取。

示例值:

6d1bxxxx

Body 参数application/json

leave_name

string

假期名称。

必需

leave_view_unit

string

必需

请假单位。day：天halfDay：半天hour：小时

biz_type

string

必需

假期类型。general_leave：普通假期lieu_leave：加班转调休

natural_day_leave

boolean

必需

是否按照自然日统计请假时长。当为false的时候，用户发起请假时候会根据用户在请假时间段内的排班情况来计算请假时长

op_userid

string

必需

当前企业内拥有“OA审批”应用权限的管理员的userid。

hours_in_per_day

number

必需

每天折算的工作时长，百分之一。例如：1天=10小时=1000。

extras

string

可选

调休假有效期规则。validity_type：有效类型 absolute_time：绝对时间relative_time：相对时间validity_value：延长日期当validity_type为absolute_time该值该值不为空且满足“yy-mm”格式。当validity_type为relative_time该值为大于1的整数。

submit_time_rule

object

可选

submit_time_rule.time_value

number

可选

限制值。当timeUnit为day时，有效值范围是0至30天；timeUnit为hour时，有效值范围是0至24小时。

submit_time_rule.time_unit

string

可选

时间单位：day：天hour：小时

submit_time_rule.time_type

string

可选

限制类型：before：提前after：补交

submit_time_rule.enable_time_limit

boolean

可选

是否开启限时提交功能，仅且为true时开启。

leave_certificate

object

请假证明。

可选

leave_certificate.unit

string

可选

请假证明单位：hour：小时day：天

leave_certificate.duration

number

可选

超过多长时间需提供请假证明。

leave_certificate.enable

boolean

是否开启请假证明。

可选

leave_certificate.prompt_information

string

请假提示文案。

可选

示例

{
  "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
  }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

errcode

number

返回码。

可选

errmsg

string

返回码描述。

可选

success

boolean

是否正确访问。

可选

result

object

返回结果。

可选

leave_name

string

假期名称。

可选

leave_code

string

假期类型唯一标识。

可选

leave_view_unit

string

可选

请假单位。day：天halfDay：半天hour：小时

leave_certificate

object

请假证明。

可选

leave_certificate.unit

string

可选

请假证明单位：hour：小时day：天

leave_certificate.duration

number

可选

超过多长时间需提供请假证明。

leave_certificate.enable

boolean

是否开启请假证明。

可选

leave_certificate.prompt_information

string

请假提示文案。

可选

submit_time_rule

object

限时提交规则。

可选

submit_time_rule.time_value

number

可选

限制值。当timeUnit为day时，有效值范围是0至30天；timeUnit为hour时，有效值范围是0至24小时。

submit_time_rule.time_unit

string

可选

时间单位：day：天hour：小时

submit_time_rule.time_type

string

可选

限制类型：before：提前after：补交

submit_time_rule.enable_time_limit

boolean

可选

是否开启限时提交功能，仅且为true时开启。

biz_type

string

可选

假期类型。general_leave：普通假期lieu_leave：加班转调休

natural_day_leave

boolean

可选

是否按照自然日统计请假时长。当为false的时候，用户发起请假时候会根据用户在请假时间段内的排班情况来计算请假时长。

hours_in_per_day

number

可选

每天折算的工作时长，百分之一。例如：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
  }
}

说明#

权限#

请求参数

示例代码

返回响应

说明

权限