创建班次
更新于 2024-06-11调用本接口，创建钉钉考勤班次。
例如，调用本接口创建了一个考勤班次，名称为接口创建班次。接口调用成功后，创建的班次在班次管理列表展示，如下图所示。
权限
服务端API是以应用维度授权的，在调用接口前，确保已经为应用添加了接口权限。
应用类型 | 是否支持调用 | 权限申请方式 | API Explorer调试 |
企业内部应用 | 是 | 考勤组管理权限 | |
第三方企业应用 | 否 | — | — |
第三方个人应用 | 否 | — | — |
基本信息
请求方式：POST
请求地址：https://oapi.dingtalk.com/topapi/attendance/shift/add
Query参数
名称 | 类型 | 是否必填 | 示例值 | 描述 |
access_token | String | 是 | 6d1bxxxx | 调用该接口的应用凭证。
|
Body参数
名称 | 类型 | 是否必填 | 示例值 | 描述 |
op_user_id | String | 是 | user01 | 操作人userId。 |
shift | TopAtClassVo | 是 | 班次。 | |
owner | String | 否 | user01 | 班次owner。 |
class_group_name | String | 否 | def | 班次组名。 |
corp_id | String | 否 | ding23 | 企业的corpId，可在开发者后台查看。  |
name | String | 是 | 白班 | 班次名称。 |
id | Number | 否 | 124 | 班次id，可通过获取班次摘要信息接口获取id参数值。 说明 id 不传值时为创建班次，传值时是修改已有班次。 |
sections | TopAtSectionVo[] | 是 | 卡段。 | |
times | TopAtTimeVo[] | 是 | 打卡信息。 | |
check_type | String | 是 | OnDuty | 打卡类型：
|
across | Number | 是 | 0 | 是否跨天：
|
end_min | Number | 否 | -1 | 允许的最晚打卡时间，单位分钟（-1表示不限制）。 |
check_time | Date | 是 | 2020-12-02 09:00:00 | 打卡时间。 |
free_check | Boolean | 否 | false | 是否免打卡：
|
begin_min | Number | 否 | 30 | 允许的最早提前打卡时间，分钟为单位。 |
setting | TopAtClassSettingVo | 否 | 设置。 | |
rest_begin_time | TopAtTimeVo | 否 | 休息开始。 | |
check_type | String | 否 | OnDuty | 休息类型：
|
check_time | Date | 否 | 2020-12-02 09:00:00 | 休息打卡时间。 |
free_check | Boolean | 否 | false | 是否免打卡：
|
across | Number | 否 | 0 | 是否跨天，跨天是指休息时间是第二天：
|
class_id | Number | 否 | 221 | 班次id，可通过获取班次摘要信息接口获取id参数值。 |
is_flexible | Boolean | 否 | false | 是否弹性。
|
corp_id | String | 否 | ding121 | 企业的corpId，可在开发者后台查看。  |
is_deleted | String | 否 | N | 是否删除。
|
rest_end_time | TopAtTimeVo | 否 | 休息结束。 | |
check_type | String | 否 | OffDuty | 休息类型：
|
check_time | Date | 否 | 2020-12-02 09:00:00 | 休息时间。 |
free_check | Boolean | 否 | false | 是否免打卡：
|
across | Number | 否 | 1 | 是否跨天，跨天是指休息时间是第二天：
|
serious_late_minutes | Number | 否 | 31 | 严重早退/迟到的时长，单位分钟。 |
absenteeism_late_minutes | Number | 否 | 60 | 旷工早退/迟到的时长，单位分钟。 说明 旷工迟到的分钟数必须比严重迟到分钟数多。 |
extras | Json | 否 | {"cause":"{\"type\":\"approve\",\"relatedId\":\"43494469-21a6-4111-953b-7810a709f27f\"}"} | 班次设置扩展字段，非临时班次无需填写。 |
tags | String | 否 | temp:schedule:isv | 班次tags，非临时班次无需填写。 |
service_id | Number | 否 | 123 | 高级排班绑定服务id，非临时班次无需填写。 |
返回参数
名称 | 类型 | 示例值 | 描述 |
result | TopAtClassVo | 班次信息。 | |
id | Number | 706715401 | 班次id。 |
name | String | A1 | 班次名称。 |
errmsg | String | ok | 返回码描述。 |
errcode | Number | 0 | 返回码。 |
success | Boolean | true | 是否成功。
|
request_id | String | wp2oh4e4vlbu | 请求ID。 |
示例
请求示例（HTTP）
请求正文
请求示例（JAVA SDK）
返回示例
