获取打卡结果
POST
/attendance/list说明
调用本接口返回企业内员工的实际打卡结果。
服务地址:https://oapi.dingtalk.com
权限
服务端API是以应用维度授权的,在调用接口前,确保已经为应用添加了接口权限。详情请参考权限申请。
应用类型 | 是否支持调用 | 权限申请方式 | API Explorer调试 |
---|---|---|---|
企业内部应用 | 是 | 开发者后台申请 | 调试 |
第三方企业应用 | 是 | 开发者后台申请 | 调试 |
第三方个人应用 | 否 | — | — |
请求参数
调用服务端API的应用凭证。企业内部应用可通过获取企业内部应用的access_token接口获取。第三方企业应用可通过获取第三方企业应用的access_token接口获取。
查询考勤打卡记录的起始工作日。格式为“yyyy-MM-dd HH:mm:ss”,HH:mm:ss可以使用00:00:00,将返回此日期从0点到24点的结果。workDateFrom ≤ x ≤ workDateEnd,即起始与结束工作日最多相隔7天(包含7天)。
查询考勤打卡记录的结束工作日。格式为“yyyy-MM-dd HH:mm:ss”,HH:mm:ss可以使用00:00:00,将返回此日期从0点到24点的结果。workDateFrom ≤ x ≤ workDateEnd,即起始与结束工作日最多相隔7天(包含7天)。
员工在企业内的userid列表,最多不能超过50个。
表示获取考勤数据的起始点。第一次传0,如果还有多余数据,下次获取传的offset值为之前的offset+limit,0、1、2...依次递增。
表示获取考勤数据的条数,最大不能超过50条。
是否为海外企业使用:true:海外平台使用false(默认):国内平台使用
{
"workDateFrom": "2020-09-06 00:00:00",
"offset": 0,
"userIdList": [
"manager"
],
"limit": 10,
"isI18n": false,
"workDateTo": "2020-09-07 00:00:00"
}
示例代码
返回响应
数据来源:ATM:考勤机打卡(指纹/人脸打卡)BEACON:IBeaconDING_ATM:钉钉考勤机(考勤机蓝牙打卡)USER:用户打卡BOSS:老板改签APPROVE:审批系统SYSTEM:考勤系统AUTO_CHECK:自动打卡
计算迟到和早退,基准时间。
实际打卡时间, 用户打卡时间的毫秒数。
关联的审批实例ID,当该字段非空时,表示打卡记录与请假、加班等审批有关。可以与获取审批实例详情配合使用。
关联的审批ID,当该字段非空时,表示打卡记录与请假、加班等审批有关。
位置结果:Normal:范围内Outside:范围外NotSigned:未打卡
打卡结果:Normal:正常Early:早退Late:迟到SeriousLate:严重迟到Absenteeism:旷工迟到NotSigned:未打卡
考勤类型:OnDuty:上班OffDuty:下班
打卡人的UserID。
分页返回参数,表示是否还有更多数据。
{
"recordresult": [
{
"sourceType": "string",
"baseCheckTime": "string",
"userCheckTime": "string",
"procInstId": "string",
"approveId": 0,
"locationResult": "string",
"timeResult": "string",
"checkType": "string",
"userId": "string",
"workDate": "string",
"recordId": 0,
"planId": 0,
"groupId": 0,
"id": 0
}
],
"hasMore": true,
"errmsg": "string",
"errcode": 0
}