考勤接口

class dingtalk.client.api.Attendance(client=None)

getleaveapproveduration(userid, from_date, to_date)

计算请假时长

参数:

• userid – 员工在企业内的UserID，企业用来唯一标识用户的字段。
• from_date – 请假开始时间
• to_date – 请假结束时间

返回:

请假时长（单位分钟）

getleavestatus(userid_list, start_time, end_time, offset=0, size=20)

请假状态查询接口 该接口用于查询指定企业下的指定用户在指定时间段内的请假状态

参数:

• userid_list – 待查询用户id列表，支持最多100个用户的批量查询
• start_time – 开始时间 ，时间戳，支持最多180天的查询
• end_time – 结束时间，时间戳，支持最多180天的查询
• offset – 分页偏移，非负整数
• size – 分页大小，正整数，最大20

getsimplegroups(offset=0, size=10)

获取考勤组列表详情

参数:

• offset – 偏移位置
• size – 分页大小，最大10

返回:

getusergroup(userid)

获取用户考勤组

参数:userid – 员工在企业内的UserID，企业用来唯一标识用户的字段。 返回:

list(work_date_from, work_date_to, user_ids=(), offset=0, limit=50)

考勤打卡数据开放

参数:

• work_date_from – 查询考勤打卡记录的起始工作日
• work_date_to – 查询考勤打卡记录的结束工作日
• user_ids – 员工在企业内的UserID列表，企业用来唯一标识用户的字段
• offset – 表示获取考勤数据的起始点，第一次传0，如果还有多余数据，下次获取传的offset值为之前的offset+limit
• limit – 表示获取考勤数据的条数，最大不能超过50条

返回:

list_record(user_ids, check_date_from, check_date_to)

考勤打卡记录开放

参数:

• user_ids – 企业内的员工id列表，最多不能超过50个
• check_date_from – 查询考勤打卡记录的起始工作日
• check_date_to – 查询考勤打卡记录的结束工作日。注意，起始与结束工作日最多相隔7天

返回:

listschedule(work_date, offset=0, size=200)

考勤排班信息按天全量查询接

参数:

• work_date – 排班时间
• offset – 偏移位置
• size – 分页大小，最大200

返回: