批量更新假期余额

说明

调用本接口批量更新假期余额信息。
服务地址：https://oapi.dingtalk.com

权限

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

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

请求参数

Query 参数

access_token

string

必需

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

示例值:

6d1bxxxx

Body 参数application/json

leave_quotas

array [object {8}]

必需

待更新的假期余额记录。

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”。

op_userid

string

必需

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

示例

{
  "leave_quotas": [
    {
      "start_time": 1653851001000,
      "reason": "管理员导入",
      "quota_num_per_day": 100,
      "quota_cycle": "2019",
      "end_time": 1753851001000,
      "leave_code": "f84a2dxxxx",
      "quota_num_per_hour": 100,
      "userid": "user1"
    }
  ],
  "op_userid": "manager1"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

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

说明#

权限#

请求参数

示例代码

返回响应

说明

权限