初始化假期余额
POST
/topapi/attendance/vacation/quota/init最后修改时间:: 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。
leave_quotas
object
必需
待初始化的假期余额记录。
userid
string
必需
员工的userid。
end_time
number
必需
额度有效期结束时间,毫秒级时间戳。
start_time
number
必需
额度有效期开始时间,毫秒级时间戳。
leave_code
string
假期类型唯一标识。
reason
string
操作原因。
quota_num_per_day
number
可选
以天计算的额度总数。假期类型按天计算时,该值不为空且按百分之一天折算。 例如:1000=10天。
quota_num_per_hour
number
可选
以小时计算的额度总数。假期类型按小时,计算该值不为空且按百分之一小时折算。例如:1000=10小时。
quota_cycle
string
可选
额度所对应的周期。除了假期类型为调休的时候可以为空之外,其他情况均不能为空且格式必须满足“yyyy”。
示例
{
"leave_quotas": {
"start_time": "1553851001000",
"reason": "管理员导入",
"quota_num_per_day": "100",
"quota_cycle": "2019",
"end_time": "1653851001000",
"leave_code": "f84a2829-xxxx0653",
"quota_num_per_hour": "100",
"userid": "user1"
},
"op_userid": "user1"
}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
result
array [object {2}]
返回结果。
reason
string
失败原因。
quota
object
失败记录。
errcode
number
返回码。
errmsg
string
可选
调用失败时返回的错误信息。
success
boolean
是否正确访问。
request_id
string
请求ID。
示例
{
"result": [
{
"reason": "string",
"quota": {
"leave_code": "string",
"userid": "string",
"quota_cycle": "string"
}
}
],
"errcode": 0,
"errmsg": "string",
"success": true,
"request_id": "string"
}
最后修改时间: 2 年前