钉钉 API

获取用户考勤数据

POST

/topapi/attendance/getupdatedata

企业内部应用oapi

**
接口调用量说明**钉钉标准版接口累计可调用次数为1万次/月，当前接口会消耗调用次数。若该调用量无法满足需求，你可升级钉钉专业版(Open API调用量50万次/月)或钉钉专属版(Open API调用量500万次/月)扩容调用次数。

调用本接口，获取指定用户当天的考勤数据。

调用本接口，可获取用户的考勤数据，包括打卡流水记录、打卡结果和审批列表等。

权限

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

应用类型	是否支持调用	权限申请方式	API Explorer调试
企业内部应用	是	查询企业考勤数据权限	调试
第三方企业应用	否	—	—
第三方个人应用	否	—	—

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://oapi.dingtalk.com/topapi/attendance/getupdatedata?access_token=6d1bxxxx' \
--header 'Content-Type: application/json' \
--data-raw '{
    "work_date": "2021-01-14 09:00:00",
    "userid": "user01"
}'

响应示例

{
  "errcode": 0,
  "result": {
    "approve_list": [],
    "attendance_result_list": [
      {
        "location_method": "MAP",
        "record_id": 53429818546,
        "group_id": 710705191,
        "location_result": "Normal",
        "class_id": 709595172,
        "time_result": "Late",
        "user_address": "绿城未来park",
        "user_check_time": "2021-01-14 11:21:59",
        "plan_check_time": "2021-01-14 09:00:00",
        "check_type": "OnDuty",
        "source_type": "USER",
        "plan_id": 176929277767
      }
    ],
    "corpId": "dinge8xxxx",
    "work_date": "2021-01-14 09:00:00",
    "userid": "user01",
    "check_record_list": [
      {
        "record_id": 52710882700,
        "user_check_time": "2021-01-14 11:19:04",
        "valid_matched": false,
        "user_accuracy": "15.0",
        "source_type": "USER",
        "invalid_record_msg": "外勤打卡需要审批",
        "invalid_record_type": "Other",
        "user_longitude": "120.017267",
        "user_latitude": "30.286036"
      },
      {
        "record_id": 53019968340,
        "user_check_time": "2021-01-14 17:00:45",
        "valid_matched": false,
        "source_type": "ATM",
        "invalid_record_msg": "当前不在可打卡的时间范围，请和管理员联系",
        "invalid_record_type": "Other"
      }
    ]
  },
  "success": true,
  "request_id": "f1zwcp4fr28h"
}

请求参数

Query 参数

access_token

必需

调用服务端接口的授权凭证，可通过获取企业内部应用的access_token接口获取。

示例值:

6d1bxxxx

Body 参数application/json

userid

string

必需

用户的userId。

work_date

string

查询日期。

必需

示例

返回响应

🟢200成功

application/json

Body

errmsg

string

返回码描述。

可选

result

object

调用结果。

可选

work_date

string

查询日期

可选

attendance_result_list

array [object {14}]

打卡结果。

可选

userid

string

用户userId。

可选

approve_list

array [object {9}]

审批单列表。

可选

check_record_list

array [object {13}]

打卡详情。

可选

corpId

string

企业corpId。

可选

class_setting_info

object

可选

当前排班对应的休息时间段。

errcode

number

返回码。

可选

success

boolean

调用成功的标志。

可选

request_id

string

请求ID。

可选

修改于 2024-01-11 03:54:46

查询是否启用智能统计报表

获取报表假期数据

获取用户考勤数据

权限#

请求参数

返回响应

权限