钉钉开发文档

获取用户考勤组

更新时间: 2018-11-20

在钉钉考勤应用中,考勤组是一类具有相同的班次、考勤位置等考勤规则的人或部门的组合,一个企业中的一个人只能属于一个考勤组。如果您的企业使用了钉钉考勤并希望获取员工的考勤组信息,可选择使用此接口。

请求方式:POST(HTTPS)
请求地址https://oapi.dingtalk.com/topapi/attendance/getusergroup?access_token=ACCESS_TOKEN
参数说明

名称 类型 是否必须 示例值 描述
userid String 必须 zhangsan 员工在企业内的UserID,企业用来唯一标识用户的字段

SDK请求示例(JAVA)

DefaultDingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/attendance/getusergroup");
OapiAttendanceGetusergroupRequest request = new OapiAttendanceGetusergroupRequest();
request.setUserid("1226682231742708");
OapiAttendanceGetusergroupResponse response = client.execute(request,accessToken);

返回结果

{
    "result":{
        "name":"考勤组1",
        "group_id":123,
        "type":"TURN",
        "classes":[
            {
                    "class_id":456,
                    "name":"A班",
                    "sections":[
                        {
                                "times":[
                                    {
                                            "check_time":"1970-01-01 12:00:00",
                                            "check_type":"OnDuty",
                                            "across":0,
                                            "begin_min":30,
                                            "end_min":0
                                    }
                                ]
                        }
                    ],
                    "setting":{
                        "rest_begin_time":{
                            "across":0,
                            "begin_min":0,
                            "end_min":0,
                            "check_time":"1970-01-01 12:00:00",
                            "check_type":"OnDuty"
                        },
                        "rest_end_time":{
                            "across":0,
                            "begin_min":0,
                            "end_min":0,
                            "check_time":"1970-01-01 12:00:00",
                            "check_type":"OffDuty"
                        }
                    }
            }
        ]
    },
    "errcode":0,
    "errmsg":"ok"
}
参数
说明
errcode
返回码
errmsg
对返回码的文本描述内容
result
└ name
考勤组名称
└ group_id
考勤组id
└ type
考勤组类型
└ classes
考勤组中的班次列表
└ class_id
班次id
└ name
班次名称
└ sections
班次中上下班列表
└ times
班次中上下班详情列表
└ check_time
打卡时间
└ check_type
打卡类型
OnDuty:上班
OffDuty:下班
└ across
打卡时间跨几天
└ begin_min
允许的最早提前打卡时间,分钟为单位
└ end_min
允许的最晚延后打卡时间,分钟为单位
└ setting
班次配置
└ rest_begin_time
休息开始时间
└ across
across
└ begin_min
beginMin
└ end_min
endMin
└ check_time
开始时间
└ check_type
类型OnDuty:休息开始,OffDuty:休息结束
└ rest_end_time
休息结束时间
└ across
across
└ begin_min
beginMin
└ end_min
endMin
└ check_time
结束时间
└ check_type
类型
OnDuty:休息开始
OffDuty:休息结束
以上内容是否对您有帮助:
在文档使用中是否遇到以下问题(多选):
  • 内容错误
  • 更新不及时
  • 链接错误
  • 缺少代码/图片示例
  • 太简单/步骤待完善
手机号
更多建议
提交成功,感谢您的反馈!