获取打卡月报数据 - Developer OpenAPI

企业可通过打卡应用Secret调用本接口，获取指定员工指定时间段内的打卡月报统计数据。
第三方应用可获取应用可见范围内指定员工指定日期内的打卡月报统计数据。

权限说明:
仅允许通过打卡应用的secret获取到的access_token调用。

调用频率:
接口调用频率限制为60次/分钟。
文档ID: 25798
原文档地址：
https://open.work.weixin.qq.com/api/doc/90000/90135/93387
https://open.work.weixin.qq.com/api/doc/90001/90143/94207

请求参数

Query 参数

access_token

string

必需

调用接口凭证，必须使用打卡应用的Secret获取access_token，获取方式参考：文档-获取access_token

示例值:

Body 参数application/json

useridlist

array[string]

可选

获取月报的userid列表。单个userid不少于1字节，不多于64字节可填充个数：1 ~ 100

endtime

integer <int32>

可选

获取月报的结束时间。0点Unix时间戳

starttime

integer <int32>

可选

获取月报的开始时间。0点Unix时间戳

示例

{
  "starttime": 1599062400,
  "endtime": 1599408000,
  "useridlist": [
    "ZhangSan"
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

可选

datas

array [object {5}]

可选

exception_infos

array [object {3}]

可选

overwork_info

object

加班情况

可选

sp_items

array [object {6}]

假勤统计信息

可选

base_info

object

基础信息

可选

summary_info

object

汇总信息

可选

errmsg

string

可选

示例

{
  "errcode": 0,
  "datas": [
    {
      "exception_infos": [
        {
          "duration": 0,
          "exception": 0,
          "count": 0
        }
      ],
      "overwork_info": {
        "workday_over_sec": 0,
        "holidays_over_sec\t": "string",
        "restdays_over_sec": "string"
      },
      "sp_items": [
        {
          "duration": 0,
          "time_type": 0,
          "count": 0,
          "name": "string",
          "vacation_id": 0,
          "type": 0
        }
      ],
      "base_info": {
        "name_ex": "string",
        "name": "string",
        "departs_name": "string",
        "rule_info": {
          "groupid": 0,
          "groupname": "string"
        },
        "acctid": "string",
        "record_type": 0
      },
      "summary_info": {
        "except_days": 0,
        "regular_work_sec": 0,
        "work_days": 0,
        "standard_work_sec": 0,
        "regular_days": "string"
      }
    }
  ],
  "errmsg": "string"
}