工具 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个。