获取用户考勤数据

说明

调用本接口获取指定用户当天的考勤数据，包括打卡流水记录、打卡结果和审批列表等。
服务地址：https://oapi.dingtalk.com

权限

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

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

请求参数

Query 参数

access_token

string

必需

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

示例值:

6d1bxxxx

Body 参数application/json

userid

string

必需

用户的userId。

work_date

string

查询日期。

必需

示例

{
  "work_date": "2021-01-14 09:00:00",
  "userid": "user01"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢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。

可选

示例

{
  "errmsg": "string",
  "result": {
    "work_date": "string",
    "attendance_result_list": [
      {
        "record_id": 0,
        "source_type": "string",
        "plan_check_time": "string",
        "class_id": 0,
        "location_method": "string",
        "location_result": "string",
        "outside_remark": "string",
        "plan_id": 0,
        "user_address": "string",
        "group_id": 0,
        "user_check_time": "string",
        "procInst_id": "string",
        "check_type": "string",
        "time_result": "string"
      }
    ],
    "userid": "string",
    "approve_list": [
      {
        "duration_unit": "string",
        "duration": "string",
        "sub_type": "string",
        "tag_name": "string",
        "procInst_id": "string",
        "begin_time": "string",
        "biz_type": 0,
        "end_time": "string",
        "gmt_finished": "string"
      }
    ],
    "check_record_list": [
      {
        "record_id": 0,
        "source_type": "string",
        "user_accuracy": "string",
        "valid_matched": true,
        "user_check_time": "string",
        "user_longitude": "string",
        "user_ssid": "string",
        "base_accuracy": "string",
        "user_mac_addr": "string",
        "user_latitude": "string",
        "base_address": "string",
        "invalid_record_msg": "string",
        "invalid_record_type": "string"
      }
    ],
    "corpId": "string",
    "class_setting_info": {
      "rest_time_vo_list": [
        {
          "rest_end_time": 0,
          "rest_begin_time": 0
        }
      ]
    }
  },
  "errcode": 0,
  "success": true,
  "request_id": "string"
}

说明#

权限#

请求参数

示例代码

返回响应

说明

权限