获取打卡结果

POST

http://127.0.0.1/attendance/list

服务端API/考勤/考勤打卡

最后修改时间：2022-08-30 09:19:22

责任人：未设置

说明

调用本接口返回企业内员工的实际打卡结果。
服务地址：https://oapi.dingtalk.com

权限

服务端API是以应用维度授权的，在调用接口前，确保已经为应用添加了接口权限。详情请参考权限申请。

应用类型	是否支持调用	权限申请方式	API Explorer调试
企业内部应用	是	开发者后台申请	调试
第三方企业应用	是	开发者后台申请	调试
第三方个人应用	否	—	—

请求参数

Query 参数

access_token

string

必需

调用服务端API的应用凭证。企业内部应用可通过获取企业内部应用的access_token接口获取。第三方企业应用可通过获取第三方企业应用的access_token接口获取。

示例值:

6d1bxxxx

Body 参数application/json

workDateFrom

string

必需

查询考勤打卡记录的起始工作日。格式为“yyyy-MM-dd HH:mm:ss”，HH:mm:ss可以使用00:00:00，将返回此日期从0点到24点的结果。workDateFrom ≤ x ≤ workDateEnd，即起始与结束工作日最多相隔7天（包含7天）。

workDateTo

string

必需

查询考勤打卡记录的结束工作日。格式为“yyyy-MM-dd HH:mm:ss”，HH:mm:ss可以使用00:00:00，将返回此日期从0点到24点的结果。workDateFrom ≤ x ≤ workDateEnd，即起始与结束工作日最多相隔7天（包含7天）。

userIdList

array[string]

必需

员工在企业内的userid列表，最多不能超过50个。

offset

number

必需

表示获取考勤数据的起始点。第一次传0，如果还有多余数据，下次获取传的offset值为之前的offset+limit，0、1、2...依次递增。

limit

number

必需

表示获取考勤数据的条数，最大不能超过50条。

isI18n

boolean

可选

是否为海外企业使用：true：海外平台使用false（默认）：国内平台使用

示例

{
  "workDateFrom": "2020-09-06 00:00:00",
  "offset": 0,
  "userIdList": [
    "manager"
  ],
  "limit": 10,
  "isI18n": false,
  "workDateTo": "2020-09-07 00:00:00"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://127.0.0.1/attendance/list?access_token=6d1bxxxx' \
--header 'Content-Type: application/json' \
--data-raw '{
    "workDateFrom": "2020-09-06 00:00:00",
    "offset": 0,
    "userIdList": [
        "manager"
    ],
    "limit": 10,
    "isI18n": false,
    "workDateTo": "2020-09-07 00:00:00"
}'

返回响应

🟢200成功

application/json

Body

recordresult

array [object {14}]

打卡记录。

可选

sourceType

string

可选

数据来源：ATM：考勤机打卡（指纹/人脸打卡）BEACON：IBeaconDING_ATM：钉钉考勤机（考勤机蓝牙打卡）USER：用户打卡BOSS：老板改签APPROVE：审批系统SYSTEM：考勤系统AUTO_CHECK：自动打卡

baseCheckTime

string

可选

计算迟到和早退，基准时间。

userCheckTime

string

可选

实际打卡时间, 用户打卡时间的毫秒数。

procInstId

string

可选

关联的审批实例ID，当该字段非空时，表示打卡记录与请假、加班等审批有关。可以与获取审批实例详情配合使用。

approveId

number

可选

关联的审批ID，当该字段非空时，表示打卡记录与请假、加班等审批有关。

locationResult

string

可选

位置结果：Normal：范围内Outside：范围外NotSigned：未打卡

timeResult

string

可选

打卡结果：Normal：正常Early：早退Late：迟到SeriousLate：严重迟到Absenteeism：旷工迟到NotSigned：未打卡

checkType

string

可选

考勤类型：OnDuty：上班OffDuty：下班

userId

string

可选

打卡人的UserID。

workDate

string

工作日。

可选

recordId

number

打卡记录ID。

可选

planId

number

排班ID。

可选

groupId

number

考勤组ID。

可选

number

唯一标识ID。

可选

hasMore

boolean

可选

分页返回参数，表示是否还有更多数据。

errmsg

string

返回码描述。

可选

errcode

number

返回码。

可选

示例

{
  "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
}

groupId转换为groupKey

获取打卡详情

获取打卡结果

说明#

权限#

请求参数

示例代码

返回响应

说明

权限