企业内部开发
基础
连接微信
办公
会议
会议统计管理
企业内部开发
服务端API
文档
管理收集表
收集表的统计信息查询
收集表的统计信息查询
最后更新:2023/03/07

该接口用于获取收集表的统计信息、已回答成员列表和未回答成员列表

请求方式:POST(HTTPS
请求地址: https://qyapi.weixin.qq.com/cgi-bin/wedoc/get_form_statistic?access_token=ACCESS_TOKEN

请求包体

// 仅获取统计结果
{
    "repeated_id":"REPEATED_ID1",
    "req_type":1
}
// 获取已提交的列表
{
    "repeated_id":"REPEATED_ID2",
    "req_type":2,
    "start_time":1667395287,
    "end_time":1668418369,
    "limit":20,
    "cursor":1
}
// 获取未提交的列表
{
    "repeated_id":"REPEATED_ID3",
    "req_type":3,
    "limit":20,
    "cursor":1
}

参数说明

参数类型是否必须说明
repeated_idstring操作的收集表的repeated_id,来源于get_form_info的返回
req_typeuint32请求类型 1:只获取统计结果 2:获取已提交列表 3:获取未提交列表
start_timeuint64拉取已提交列表时必填,其余type不填。筛选开始时间,以当天的00:00:00开始筛选
end_timeuint64拉取已提交列表时必填,其余type不填。筛选结束时间,以当天的23:59:59结束筛选
limituint64分页拉取时批次大小,最大10000
cursoruint64分页拉取的游标,首次不传

权限说明

  • 自建应用需配置到“可调用应用”列表中的应用secret所获取的accesstoken来调用(accesstoken如何获取?
  • 第三方应用需具有“文档”权限
  • 代开发自建应用需具有“文档”权限
  • 只能操作该应用创建的文档

返回示例

// req_type = 1 仅获取统计信息
{
    "errcode":0,
    "errmsg":"ok",
    "fill_cnt":1,
    "fill_user_cnt":1,
    "unfill_user_cnt":90
}
// req_type = 2,获取已提交列表
{
    "errcode":0,
    "errmsg":"ok",
    "fill_cnt":1,
    "fill_user_cnt":1,
    "unfill_user_cnt":90,
    "submit_users":[
        {
            "userid":"USERID1",
            "submit_time":1668418200,
            "answer_id":1,
            "user_name":"USER_NAME1"
        },
        {
            "tmp_external_userid":"TMP_EXTERNAL_USERID1",
            "submit_time":1668418200,
            "answer_id":2,
            "user_name":"USER_NAME2"
        }
     ],
    "has_more":false,
    "cursor":1
}
// req_type = 3,获取未提交列表,仅当限制提交范围时有结果
{
    "errcode":0,
    "errmsg":"ok",
    "fill_cnt":1,
    "fill_user_cnt":1,
    "unfill_user_cnt":90,
    "unfill_users":[
        {
            "userid":"USERID1",
            "user_name":"USER_NAME1"
        }
    ],
    "has_more":false,
    "cursor":1
} 

参数说明

参数类型说明
errcodeint32错误码
errmsgstring错误码说明
fill_cntuint64已填写次数
fill_user_cntuint64已填写人数
unfill_user_cntuint64未填写人数
submit_usersobject[]已填写人列表
tmp_external_useridstring外部用户临时id,匿名填写不返回,同一个用户在不同的收集表中返回的该id不一致。
可进一步通过tmp_external_userid的转换接口转换成external_userid,方便识别外部填写人的身份。
useridstring企业内成员的id,匿名填写不返回
submit_timeuint64提交时间
answer_iduint64答案id
user_namestring名字,匿名填写不返回
useridstring企业内成员的id,匿名填写不返回
unfill_usersobject[]未填写人列表
user_namestring名字
useridstring企业内成员的id
has_morebool是否还有更多
cursoruint64上次分页拉取返回的cursor
上一篇获取收集表信息
下一篇读取收集表答案
    本节内容
服务端API
基础
连接微信
办公
会议
会议统计管理
客户端API
小程序
基础
连接微信
办公
WECOM-JSSDK
JS-SDK
基础
连接微信
办公
更新日志
联系我们