dingtalk.oapi.attendance.getsimplegroups (获取考勤组列表详情)

获取公司自身的考勤组列表详情信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
offset Number 可选 0
  • 默认值:0
  • 偏移位置
    size Number 可选 10
  • 默认值:10
  • 分页大小,最大10

    响应参数

    名称 类型 示例值 描述
    errcode Number 0 errcode
    errmsg String ok errmsg
    result AtGroupListForTopVo {} result
    • └ has_more
    • Boolean
    • true
    • 分页用,表示是否还有下一页
    • groups
    • AtGroupForTopVo []
    • []
    • 考勤组列表
    • └ group_id
    • Number
    • 20015047
    • 考勤组id
    • └ is_default
    • Boolean
    • false
    • 是否默认考勤组
    • └ group_name
    • String
    • 固定排班
    • 考勤组名称
    • selected_class
    • AtClassVo []
    • []
    • 考勤组对应的考勤班次列表
    • setting
    • ClassSettingVo
    • {}
    • 考勤组班次配置
    • rest_begin_time
    • AtTimeVo
    • 休息开始时间,只有一个时间段的班次有
    • └ check_time
    • Date
    • 2017-04-11 11:11:11
    • 开始时间
    • └ permit_late_minutes
    • Number
    • 10
    • 允许迟到时长,单位分钟
    • └ work_time_minutes
    • Number
    • -1
    • 工作时长,单位分钟,-1表示关闭该功能
    • rest_end_time
    • AtTimeVo
    • 休息结束时间,只有一个时间段的班次有
    • └ check_time
    • Date
    • 2017-04-11 11:11:11
    • 结束时间
    • └ absenteeism_late_minutes
    • Number
    • 30
    • 旷工迟到时长,单位分钟
    • └ serious_late_minutes
    • Number
    • 20
    • 严重迟到时长,单位分钟
    • └ is_off_duty_free_check
    • String
    • Y
    • Y表示下班不强制打卡,N表示下班强制打卡
    • rest_time_list
    • AtTimeVo []
    • 1
    • 班次休息时段,支持多段休息
    • left
    • AtTimeVo
    • 休息开始
    • └ checkTime
    • Date
    • 1970-01-01 12:00:00
    • 休息开始时间
    • └ across
    • Number
    • 0
    • 是否跨天,0表示未跨天
    • right
    • AtTimeVo
    • 休息结束
    • └ checkTime
    • Date
    • 1970-01-01 13:00:00
    • 休息结束时间
    • └ across
    • Number
    • 0
    • 是否跨天,0表示未跨天
    • └ class_id
    • Number
    • 20008010
    • 考勤班次id
    • sections
    • AtSectionVo []
    • []
    • 班次打卡时间段,最多
    • times
    • SetionTimeVO []
    • []
    • 时间段列表
    • └ check_time
    • Date
    • 2017-04-11 11:11:11
    • 打卡时间
    • └ check_type
    • String
    • OnDuty
    • 打卡类型枚举(Onduty和OffDuty)
    • └ across
    • Number
    • 0
    • 打卡时间跨度
    • └ class_name
    • String
    • A
    • 考勤班次名称
    • └ type
    • String
    • FIXED
    • 考勤类型,FIXED为固定排班,TURN为轮班排班,NONE为无班次
    • └ member_count
    • Number
    • 1
    • 成员人数
    • └ default_class_id
    • Number
    • 111
    • 默认班次id
    • └ work_day_list
    • String []
    • 1
    • 固定班次的工作日班次
    • └ classes_list
    • String []
    • 周一、二 班次A:09:00-18:00, 周六、周日 休息
    • 一周的班次时间展示列表。["周一、二 班次A:09:00-18:00", "周六、周日 休息"]
    • └ manager_list
    • String []
    • 1,2
    • 考勤组负责人
    • └ dept_name_list
    • String []
    • 部门1,部门2
    • 关联的部门
    • └ user_ids
    • String []
    • <123,345,456>
    • 考勤组里按照人添加的人
    • └ dept_ids
    • Number []
    • <1234L, 2345L>
    • 考勤组添加的部门Id列表
    • └ owner_user_id
    • String
    • 123
    • 考勤组主负责人
    • └ freecheck_work_days
    • Number []
    • [1,2,3,4,5,6,0]
    • 自由工时考勤组工作日(1表示周一,0表示周日)
    • └ freecheck_day_start_min_offset
    • Number
    • 240
    • 自由工时考勤组考勤开始时间与当天0点偏移分钟数(如:240表示4:00)
    • └ disable_check_when_rest
    • Boolean
    • false
    • 休息日打卡需审批
    • └ enable_emp_select_class
    • Boolean
    • false
    • 未排班时允许员工选择班次打卡
    • └ disable_check_without_schedule
    • Boolean
    • false
    • 未排班时是否禁止员工打卡

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/attendance/getsimplegroups");
    OapiAttendanceGetsimplegroupsRequest req = new OapiAttendanceGetsimplegroupsRequest();
    req.setOffset(0L);
    req.setSize(10L);
    OapiAttendanceGetsimplegroupsResponse rsp = client.execute(req, access_token);
    System.out.println(rsp.getBody());

    响应示例

    • JSON示例
    {
        "errcode":0,
        "errmsg":"ok",
        "result":{
            "has_more":true,
            "groups":[
                {
                        "group_id":20015047,
                        "is_default":false,
                        "group_name":"固定排班",
                        "selected_class":[
                            {
                                    "setting":{
                                        "rest_begin_time":{
                                            "check_time":"2017-04-11 11:11:11"
                                        },
                                        "permit_late_minutes":10,
                                        "work_time_minutes":-1,
                                        "rest_end_time":{
                                            "check_time":"2017-04-11 11:11:11"
                                        },
                                        "absenteeism_late_minutes":30,
                                        "serious_late_minutes":20,
                                        "is_off_duty_free_check":"Y",
                                        "rest_time_list":[
                                            {
                                                    "left":{
                                                        "checkTime":"1970-01-01 12:00:00",
                                                        "across":0
                                                    },
                                                    "right":{
                                                        "checkTime":"1970-01-01 13:00:00",
                                                        "across":0
                                                    }
                                            }
                                        ]
                                    },
                                    "class_id":20008010,
                                    "sections":[
                                        {
                                                "times":[
                                                    {
                                                            "check_time":"2017-04-11 11:11:11",
                                                            "check_type":"OnDuty",
                                                            "across":0
                                                    }
                                                ]
                                        }
                                    ],
                                    "class_name":"A"
                            }
                        ],
                        "type":"FIXED",
                        "member_count":1,
                        "default_class_id":111,
                        "work_day_list":{
                            "string":[
                                "1"
                            ]
                        },
                        "classes_list":{
                            "string":[
                                "周一、二 班次A:09:00-18:00",
                                " 周六、周日 休息"
                            ]
                        },
                        "manager_list":{
                            "string":[
                                "1,2"
                            ]
                        },
                        "dept_name_list":{
                            "string":[
                                "部门1",
                                "部门2"
                            ]
                        },
                        "user_ids":{
                            "string":[
                                "<123",
                                "345",
                                "456>"
                            ]
                        },
                        "dept_ids":{
                            "number":[
                                <1234L,
                                 2345L>
                            ]
                        },
                        "owner_user_id":"123",
                        "freecheck_work_days":{
                            "number":[
                                [1,
                                2,
                                3,
                                4,
                                5,
                                6,
                                0]
                            ]
                        },
                        "freecheck_day_start_min_offset":240,
                        "disable_check_when_rest":false,
                        "enable_emp_select_class":false,
                        "disable_check_without_schedule":false
                }
            ]
        }
    }

    异常示例

    • JSON示例
    {
    	"errcode":88,
    	"errmsg":"ding talk error"
    }

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部