批量获取考勤组详情旧版SDK
更新于 2023-01-18
在钉钉考勤应用中，考勤组是一类具有相同的班次、考勤位置等考勤规则的人或部门的组合，企业可根据实际业务设置多个考勤组。
权限
服务端API是以应用维度授权的，在调用接口前，确保已经为应用添加了接口权限。
基本信息
请求方式：POST
请求地址：https://oapi.dingtalk.com/topapi/attendance/getsimplegroups
Query参数
名称 | 类型 | 是否必填 | 示例值 | 描述 |
access_token | String | 是 | 6d1bxxxx | 调用该接口的应用凭证。
|
Body参数
名称 | 类型 | 是否必填 | 示例值 | 描述 |
offset | Number | 否 | 0 | 支持分页查询，与size参数同时设置时才生效，该参数代表偏移量，偏移量从0开始，下次调用传上次调用时的size与offset之和。 |
size | Number | 否 | 10 | 分页大小，最大10。 |
返回参数
名称 | 类型 | 示例值 | 描述 |
request_id | String | 8pi2725sgame | 请求ID。 |
errcode | Number | 0 | 返回码。 |
errmsg | String | ok | 返回码描述。 |
result | AtGroupListForTopVo | 返回结果。 | |
has_more | Boolean | true | 分页用，表示是否有更多数据。
|
groups | AtGroupForTopVo[] | 考勤组列表。 | |
group_id | Number | 20015047 | 考勤组ID。 |
is_default | Boolean | false | 是否是默认考勤组。
|
group_name | String | 固定排班 | 考勤组名称。 |
selected_class | AtClassVo[] | 考勤组对应的考勤班次列表。 | |
enable_emp_select_class | Boolean | true | 未排班时是否允许员工选择班次打卡。
|
disable_check_without_schedule | Boolean | false | 未排班时是否禁止员工打卡。
|
disable_check_when_rest | Boolean | true | 休息日打卡是否需审批：
|
setting | ClassSettingVo | 考勤组班次配置。 | |
class_setting_id | Number | 1 | 考勤组班次ID。 |
rest_begin_time | AtTimeVo | 休息开始时间，只有一个时间段的班次有。 | |
check_time | Date | 2017-04-11 11:11:11 | 开始时间。 |
permit_late_minutes | Number | 10 | 允许迟到时长，单位分钟（-1表示关闭该功能）。 |
work_time_minutes | Number | -1 | 工作时长，单位分钟（-1表示关闭该功能）。 |
rest_end_time | AtTimeVo | 休息结束时间，只有一个时间段的班次有。 | |
check_time | Date | 2017-04-11 11:11:11 | 结束时间。 |
absenteeism_late_minutes | Number | 30 | 旷工迟到时长，单位分钟（-1表示关闭该功能）。 |
serious_late_minutes | Number | 20 | 严重迟到时长，单位分钟（-1表示关闭该功能）。 |
is_off_duty_free_check | String | Y | 是否强制下班打卡。
|
class_id | Number | 20008010 | 考勤班次ID。 |
sections | AtSectionVo[] | 班次打卡时间段。 | |
times | SetionTimeVO[] | 时间段列表。 | |
check_time | Date | 2017-04-11 11:11:11 | 打卡时间。 |
check_type | String | OnDuty | 打卡类型。
|
across | Number | 0 | 打卡时间跨度。 |
class_name | String | A | 考勤班次名称。 |
type | String | FIXED | 考勤类型。
|
member_count | Number | 1 | 参与考勤人员人数。 |
default_class_id | Number | 111 | 默认班次ID。 |
work_day_list | String[] | ["0","12","12","12","12","12","0"] | 固定班次的工作日班次。 说明
|
classes_list | String[] | ["周一、二、三、四、五 白班班次 09:00-16:00 ","周六、日 休息"] | 一周的班次时间展示列表。 |
manager_list | String[] | ["manager4220"] | 考勤组子负责人。 |
dept_name_list | String[] | ["市场部"] | 参与考勤的部门名称。 |
owner_user_id | String | user456 | 考勤组主负责人。 |
示例
请求示例（HTTP）
请求正文
请求示例（JAVA SDK）
返回示例
