获取汇报统计数据 - Developer OpenAPI

企业可通过access_token调用本接口，根据汇报表单id查询企业微信“汇报应用”的汇报统计汇总信息。该接口只能拉取到已经汇总的统计数据，对于尚未完成汇总的周期不会返回。

错误说明：

错误码	说明
301065	无汇报应用数据拉取权限
301066	请求参数错误
301067	接口内部失败

文档ID: 25846
原文档地址：
https://open.work.weixin.qq.com/api/doc/90000/90135/93395

请求参数

Query 参数

access_token

string

调用接口凭证

必需

示例值:

Body 参数application/json

endtime

integer <int32>

可选

结束时间，时间区间最大长度为一年

template_id

string

可选

汇报表单id,不多于256字节

starttime

integer <int32>

开始时间

可选

示例

{
  "template_id": "3TmALk1ogfgKiQE3e3jRwnTUhMTh8vca1N8zUVNUx",
  "starttime": 1604160000,
  "endtime": 1606363092
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

返回码

可选

errmsg

string

可选

stat_list

array [object {12}]

统计数据列表

可选

cycle_end_time

integer <int32>

周期结束时间

可选

unreport_list

array [object {2}]

未汇报用户列表

可选

template_name

string

汇报表单名称

可选

white_range

object

白名单集合

可选

stat_begin_time

integer <int32>

统计开始时间

可选

report_list

array [object {2}]

已汇报用户列表

可选

cycle_begin_time

integer <int32>

周期开始时间

可选

stat_end_time

integer <int32>

统计结束时间

可选

receivers

object

固定汇报对象

可选

template_id

string

汇报表单id

可选

report_type

integer <int32>

可选

汇报方式：2按日汇报; 3按周汇报; 4按月汇报

report_range

object

汇报人员范围

可选

示例

{
  "errcode": 0,
  "errmsg": "ok",
  "stat_list": [
    {
      "template_id": "3TmALk1ogfgKiQE3e3jRwnTUhMTh8vca1N8zUVNU",
      "template_name": "日报",
      "report_range": {
        "user_list": [
          {
            "userid": "user1"
          }
        ],
        "party_list": [
          {
            "open_partyid": "1"
          }
        ],
        "tag_list": []
      },
      "white_range": {
        "user_list": [],
        "party_list": [],
        "tag_list": []
      },
      "receivers": {
        "user_list": [
          {
            "userid": "user3"
          }
        ],
        "tag_list": [],
        "leader_list": []
      },
      "cycle_begin_time": 1606147200,
      "cycle_end_time": 1606233600,
      "stat_begin_time": 1606147200,
      "stat_end_time": 1606230000,
      "report_list": [
        {
          "user": {
            "userid": "user2"
          },
          "itemlist": [
            {
              "journaluuid": "4U9abSUrpY78VNxeNNv3J5TW5e9VLj8cDymH9py1Efpuj5X8QCDQx3stKr69pia3UL8auRjrCMsiRjgzL8mvKnff",
              "reporttime": 1606218548,
              "flag": 0
            }
          ]
        }
      ],
      "unreport_list": [
        {
          "user": {
            "userid": "user1"
          },
          "itemlist": [
            {
              "journaluuid": "",
              "reporttime": 1606147200,
              "flag": 0
            }
          ]
        },
        {
          "user": {
            "userid": "user3"
          },
          "itemlist": [
            {
              "journaluuid": "",
              "reporttime": 1606147200,
              "flag": 0
            }
          ]
        }
      ],
      "report_type": 2
    }
  ]
}