查询假期类型
POST
/topapi/attendance/vacation/type/list最后修改时间:: 2 年前
责任人: 未设置
说明
调用本接口查询假期类型。
服务地址:https://oapi.dingtalk.com
权限
服务端API是以应用维度授权的,在调用接口前,确保已经为应用添加了接口权限。详情请参考权限申请。
应用类型 | 是否支持调用 | 权限申请方式 | API Explorer调试 |
---|---|---|---|
企业内部应用 | 是 | 开发者后台申请 | 调试 |
第三方企业应用 | 是 | 开发者后台申请 | 调试 |
第三方个人应用 | 否 | — | — |
请求参数
Query 参数
access_token
string
必需
调用服务端API的应用凭证。企业内部应用可通过获取企业内部应用的access_token接口获取。第三方企业应用可通过获取第三方企业应用的access_token接口获取。
示例值:
6d1bxxxx
Body 参数application/json
op_userid
string
必需
当前企业内拥有“OA审批”应用权限的管理员的userid。
vacation_source
string
可选
假期来源。取值:all:所有假期类型null:开放接口定义假期类型
示例
{
"vacation_source": "all",
"op_userid": "user01"
}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
request_id
string
请求ID。
errcode
number
返回码。
errmsg
string
返回码描述。
success
boolean
是否正确访问。
result
array [object {19}]
返回结果。
leave_code
string
假期类型唯一标识。
leave_name
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
string
可选
是否按照自然日统计请假时长。当为false的时候,用户发起请假时候会根据用户在请假时间段内的排班情况来计算请假时长。
validity_type
string
可选
有效类型。absolute_time:绝对时间relative_time:相对时间
validity_value
string
可选
延长日期。当validity_type为absolute_time该值不为空且满足“yy-mm”格式。当validity_type为relative_time该值为大于1的整数。
hours_in_per_day
number
可选
每天折算的工作时长,百分之一。例如:1天=10小时=1000。
source
string
可选
假期来源。external:开放接口自定义的inner:oa后台新建的
示例
{
"request_id": "string",
"errcode": 0,
"errmsg": "string",
"success": true,
"result": [
{
"leave_code": "string",
"leave_name": "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": "string",
"validity_type": "string",
"validity_value": "string",
"hours_in_per_day": 0,
"source": "string"
}
]
}
最后修改时间: 2 年前