读取收集表答案 - 文档 - 企业微信开发者中心

第三方应用开发

快速入门服务端API 客户端API 工具与资源运营规范附录更新日志联系我们

第三方应用开发

服务端API

文档

管理收集表

读取收集表答案

最后更新：2023/07/12

该接口用于读取收集表的答案

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

请求包体

{
    "repeated_id":"REPEATED_ID1",
    "answer_ids":[
        1
    ]
}

参数说明

参数	类型	是否必须	说明
repeated_id	string	是	操作的收集表周期id
answer_ids	uint64[]	是	需要拉取的答案列表，批次大小最大100

权限说明

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

返回示例

{
  "errcode": 0,
  "errmsg": "ok",
  "answer": {
    "answer_list": [
      {
        "answer_id": 15,
        "user_name": "USER_NAME1",
        "ctime": 1668430580,
        "mtime": 1668430580,
        "reply": {
          "items": [
            {
              "question_id": 1,
              "text_reply": "Ndjnd"
            },
            {
              "question_id": 2,
              "option_reply": [
                2
              ]
            },
            {
              "question_id": 3,
              "text_reply": "20:53"
            },
            {
              "question_id": 4,
              "text_reply": "73℃"
            },
            {
              "question_id": 5,
              "file_extend_reply": [
                {
                  "name": "FILE_NAME1",
                  "fileid": "FILEID1"
                }
              ]
            },
            {
              "question_id": 6,
              "text_reply": "四川省/成都市/武侯区/天府三街(峰汇中心)"
            },
            {
              "question_id": 7,
              "text_reply": "test"
            },
            {
              "question_id": 8,
              "option_reply": [
                1
              ]
            },
            {
              "question_id": 9,
              "text_reply": "2022年11月"
            },
            {
              "question_id": 10,
              "option_reply": [
                5
              ]
            },
            {
              "question_id": 11,
              "option_reply": [
                3
              ],
              "option_extend_reply": [
                {
                  "option_reply": 3,
                  "extend_text": "test"
                }
              ]
            },
            {
              "question_id": 12,
              "department_reply": {
                "list": [
                  {
                    "department_id": 3
                  }
                ]
              }
            },
            {
              "question_id": 13,
              "member_reply": {
                "list": [
                  {
                    "userid": "zhangsan"
                  }
                ]
              }
            },
            {
              "question_id": 14,
              "duration_reply": {
                "begin_time": 1586136317,
                "end_time": 1586236317,
                "time_scale": 0,
                "day_range": 0,
                "days": 1.0,
                "hours": 2.5
              }
            }
          ]
        },
        "answer_status": 1,
        "tmp_external_userid": "TMP_EXTERNAL_USERID1"
      }
    ]
  }
}

参数说明

参数	类型	说明
errcode	int32	错误码
errmsg	string	错误码说明
answer	object	答案
answer_list	object[]	答案列表
answer_id	uint64	答案id
user_name	string	用户名
ctime	uint64	创建时间
mtime	uint64	修改时间
reply	object	该用户的答案明细
items	object[]	每个问题的答案
question_id	uint64	问题id
text_reply	string	答案
option_reply	uint32[]	选择题答案，多选题有多个答案
option_extend_reply	object[]	选择题，其他选项列表
option_extend_reply.option_reply	uint32	其他选项的答案id
option_extend_reply.extend_text	string	其他选项的答案字符串
file_extend_reply	object[]	文件题答案列表
file_extend_reply.name	string	文件题答案的文件名
file_extend_reply.fileid	string	文件题答案的文件id
department_reply	object	部门题答案
department_reply.list	object[]	部门题选择的部门列表
department_reply.list[].department_id	object[]	部门id
member_reply	object	成员题答案
member_reply.list	object[]	成员选择的成员列表
member_reply.list[].userid	object[]	成员id
duration_reply	object	时长题答案
duration_reply.begin_time	uint32	开始时间，时间戳
duration_reply.end_time	uint32	结束时间，时间戳
duration_reply.time_scale	uint32	时间刻度。1: 按天 2: 按小时
duration_reply.day_range	uint32	单位换算，多少小时/天。`time_scale`为`2`返回
duration_reply.days	float	天数。`time_scale`为`1`返回
duration_reply.hours	float	小时数。`time_scale`为`2`返回
answer_status	uint32	答案状态 1:正常 3:统计者移除此答案或删除
tmp_external_userid	string	外部用户临时id，匿名填写不返回，同一个用户在不同的收集表中返回的该id不一致。可进一步通过tmp_external_userid的转换接口转换成外部联系人的external_userid，方便识别外部填写人的身份。
userid	string	用户id，匿名填写不返回