获取打卡月报数据

POST

/cgi-bin/checkin/getcheckin_monthdata

服务端API企业内部开发第三方应用开发

企业可通过打卡应用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

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'https://qyapi.weixin.qq.com/cgi-bin/checkin/getcheckin_monthdata?access_token=' \
--header 'Content-Type: application/json' \
--data-raw '{"starttime":1599062400,"endtime":1599408000,"useridlist":["ZhangSan"]}'

响应示例

{
  "errcode": 0,
  "errmsg": "ok",
  "datas": [
    {
      "base_info": {
        "record_type": 1,
        "name": "张三",
        "name_ex": "Three Zhang",
        "departs_name": "有家企业/realempty;有家企业;有家企业/部门A4",
        "rule_info": {
          "groupid": 10,
          "groupname": "规则测试"
        },
        "acctid": "ZhangSan"
      },
      "summary_info": {
        "except_days": 3,
        "regular_work_sec": 31,
        "standard_work_sec": 29040,
        "work_days": 3
      },
      "exception_infos": [
        {
          "count": 2,
          "duration": 28920,
          "exception": 4
        },
        {
          "count": 1,
          "duration": 60,
          "exception": 1
        },
        {
          "count": 1,
          "duration": 60,
          "exception": 2
        }
      ],
      "sp_items": [
        {
          "count": 0,
          "duration": 0,
          "time_type": 0,
          "type": 100,
          "vacation_id": 0,
          "name": "外勤次数"
        },
        {
          "count": 1,
          "duration": 0,
          "time_type": 0,
          "type": 1,
          "vacation_id": 2,
          "name": "年假"
        }
      ],
      "overwork_info": {
        "workday_over_sec": 10800
      }
    }
  ]
}

请求参数

Query 参数

access_token

必需

调用接口凭证，必须使用打卡应用的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时间戳

示例

返回响应

🟢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

可选

修改于 2022-01-14 04:25:43

获取打卡日报数据

获取打卡人员排班信息