获取打卡详情

说明

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

权限

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

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

请求参数

Query 参数

access_token

string

必需

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

示例值:

6d1bxxxx

Body 参数application/json

userIds

object

必需

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

checkDateFrom

string

必需

查询考勤打卡记录的起始工作日。格式为：yyyy-MM-dd hh:mm:ss。

checkDateTo

string

必需

查询考勤打卡记录的结束工作日。格式为：yyyy-MM-dd hh:mm:ss。起始与结束工作日最多相隔7天。

isI18n

boolean

可选

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

示例

{
  "checkDateFrom": "2020-09-07 00:00:00",
  "userIds": [
    "user456",
    "user123"
  ],
  "isI18n": "false",
  "checkDateTo": "2020-09-08 00:00:00"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

recordresult

array [object {38}]

打卡详情。

可选

userAccuracy

string

用户打卡定位精度。

可选

classId

number

班次ID。

可选

userLatitude

string

用户打卡纬度。

可选

userLongitude

string

用户打卡经度。

可选

userAddress

string

用户打卡地址

可选

deviceId

string

打卡设备ID。

可选

locationMethod

string

定位方法。

可选

isLegal

string

可选

是否合法。Y：合法当timeResult和locationResult都为Normal时，为该值。N：不合法

userCheckTime

string

实际打卡时间。

可选

procInstId

string

可选

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

baseCheckTime

string

可选

计算迟到和早退，基准时间；也可作为排班打卡时间。

approveId

number

可选

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

timeResult

string

可选

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

locationResult

string

可选

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

checkType

string

可选

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

sourceType

string

可选

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

userId

string

可选

打卡人的userid。

workDate

string

工作日。

可选

corpId

string

企业ID。

可选

planId

number

排班ID。

可选

groupId

number

考勤组ID。

可选

number

考勤ID。

可选

invalidRecordType

string

可选

异常信息类型：Security：安全相关原因Other：其他原因

userSsid

string

可选

用户打卡wifi SSID。

userMacAddr

string

可选

用户打卡wifi Mac地址。

planCheckTime

string

排班打卡时间。

可选

baseAddress

string

基准地址。

可选

baseLongitude

string

基准经度。

可选

baseLatitude

string

基准纬度。

可选

baseAccuracy

string

基准定位精度。

可选

baseSsid

string

可选

基准wifi ssid。

baseMacAddr

string

基准Mac地址。

可选

gmtCreate

string

打卡记录创建时间。

可选

invalidRecordMsg

string

可选

对应的invalidRecordType异常信息的具体描述。

string

打卡记录修改时间。

可选

outsideRemark

string

打卡备注。

可选

deviceSN

string

打卡设备序列号。

可选

bizId

string

关联的业务ID。

可选

errmsg

string

返回码描述。

可选

errcode

number

返回码。

可选

示例

{
  "recordresult": [
    {
      "userAccuracy": "string",
      "classId": 0,
      "userLatitude": "string",
      "userLongitude": "string",
      "userAddress": "string",
      "deviceId": "string",
      "locationMethod": "string",
      "isLegal": "string",
      "userCheckTime": "string",
      "procInstId": "string",
      "baseCheckTime": "string",
      "approveId": 0,
      "timeResult": "string",
      "locationResult": "string",
      "checkType": "string",
      "sourceType": "string",
      "userId": "string",
      "workDate": "string",
      "corpId": "string",
      "planId": 0,
      "groupId": 0,
      "id": 0,
      "invalidRecordType": "string",
      "userSsid": "string",
      "userMacAddr": "string",
      "planCheckTime": "string",
      "baseAddress": "string",
      "baseLongitude": "string",
      "baseLatitude": "string",
      "baseAccuracy": "string",
      "baseSsid": "string",
      "baseMacAddr": "string",
      "gmtCreate": "string",
      "invalidRecordMsg": "string",
      "": "string",
      "outsideRemark": "string",
      "deviceSN": "string",
      "bizId": "string"
    }
  ],
  "errmsg": "string",
  "errcode": 0
}

说明#

权限#

请求参数

示例代码

返回响应

说明

权限