获取打卡日报数据

POST

/cgi-bin/checkin/getcheckin_daydata

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

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

调用频率:
接口调用频率限制为100次/分钟。

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

文档ID: 25689
原文档地址：
https://open.work.weixin.qq.com/api/doc/90000/90135/93374
https://open.work.weixin.qq.com/api/doc/90001/90143/94206

请求示例

Shell

JavaScript

Java

Swift

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

响应示例

{
  "errcode": 0,
  "errmsg": "ok",
  "datas": [
    {
      "base_info": {
        "date": 1599062400,
        "record_type": 1,
        "name": "张三",
        "name_ex": "Three Zhang",
        "departs_name": "有家企业/realempty;有家企业;有家企业/部门A4",
        "acctid": "ZhangSan",
        "rule_info": {
          "groupid": 10,
          "groupname": "规则测试",
          "scheduleid": 0,
          "schedulename": "",
          "checkintime": [
            {
              "work_sec": 38760,
              "off_work_sec": 38880
            }
          ]
        },
        "day_type": 0
      },
      "summary_info": {
        "checkin_count": 2,
        "regular_work_sec": 31,
        "standard_work_sec": 120,
        "earliest_time": 38827,
        "lastest_time": 38858
      },
      "holiday_infos": [
        {
          "sp_description": {
            "data": [
              {
                "lang": "zh_CN",
                "text": "09/03 10:00~09/03 10:01"
              }
            ]
          },
          "sp_number": "202009030002",
          "sp_title": {
            "data": [
              {
                "lang": "zh_CN",
                "text": "请假0.1小时"
              }
            ]
          }
        },
        {
          "sp_description": {
            "data": [
              {
                "lang": "zh_CN",
                "text": "08/25 14:37~09/10 14:37"
              }
            ]
          },
          "sp_number": "202008270004",
          "sp_title": {
            "data": [
              {
                "lang": "zh_CN",
                "text": "加班17.0小时"
              }
            ]
          }
        }
      ],
      "exception_infos": [
        {
          "count": 1,
          "duration": 60,
          "exception": 1
        },
        {
          "count": 1,
          "duration": 60,
          "exception": 2
        }
      ],
      "ot_info": {
        "ot_status": 1,
        "ot_duration": 3600,
        "exception_duration": []
      },
      "sp_items": [
        {
          "count": 1,
          "duration": 360,
          "time_type": 0,
          "type": 1,
          "vacation_id": 2,
          "name": "年假"
        },
        {
          "count": 0,
          "duration": 0,
          "time_type": 0,
          "type": 100,
          "vacation_id": 0,
          "name": "外勤次数"
        }
      ]
    }
  ]
}

请求参数

Query 参数

access_token

必需

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

示例值:

Body 参数application/json

useridlist

array[string]

可选

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 {6}]

日报数据列表

可选

exception_infos

array [object {3}]

校准状态信息

可选

sp_items

array [object {6}]

假勤统计信息

可选

ot_info

object

加班信息

可选

base_info

object

基础信息

可选

summary_info

object

汇总信息

可选

holiday_infos

array [object {3}]

假勤相关信息

可选

errmsg

string

可选

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

获取打卡记录数据

获取打卡月报数据