工具 API

attendance__batch_get_employee_shifts

批量查询多个员工在指定日期的考勤班次信息,返回每条记录包含:用户 ID(userId)、工作日期(workDate,毫秒时间戳)、打卡类型(checkType,如 OnDuty 表示上班)、计划打卡时间(planCheckTime,毫秒时间戳)以及是否为休息日(isRest,"Y"/"N")。结果基于组织考勤配置生成,仅返回调用者有权限查看的员工数据,适用于排班核对、考勤预览等场景。

enterpriseOAuth1 积分

调用信息

工具标识
dingtalk.attendance__batch_get_employee_shifts
服务提供方
钉钉
平均响应
41 ms
近 7 天调用
1

输入参数

fromDateTime必填

起始日期,Unix时间戳,单位毫秒。 开始时间和结束时间的间隔不能超过7天。 查询时间限制距今180天内。

toDateTime必填

结束日期,Unix时间戳,单位毫秒。开始时间和结束时间的间隔不能超过7天。 查询时间限制距今180天内。

userIds必填

要查询的人员userId列表,多个userId用列表表示,一次最多可传50个。