企业内部开发 服务端API 文档 管理收集表 读取收集表答案
读取收集表答案
最后更新:2023/07/12
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
读取收集表答案
最后更新: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_idstring操作的收集表周期id
answer_idsuint64[]需要拉取的答案列表,批次大小最大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"
      }
    ]
  }
}

参数说明

参数类型说明
errcodeint32错误码
errmsgstring错误码说明
answerobject答案
answer_listobject[]答案列表
answer_iduint64答案id
user_namestring用户名
ctimeuint64创建时间
mtimeuint64修改时间
replyobject该用户的答案明细
itemsobject[]每个问题的答案
question_iduint64问题id
text_replystring答案
option_replyuint32[]选择题答案,多选题有多个答案
option_extend_replyobject[]选择题,其他选项列表
option_extend_reply.option_replyuint32其他选项的答案id
option_extend_reply.extend_textstring其他选项的答案字符串
file_extend_replyobject[]文件题答案列表
file_extend_reply.namestring文件题答案的文件名
file_extend_reply.fileidstring文件题答案的文件id
department_replyobject部门题答案
department_reply.listobject[]部门题选择的部门列表
department_reply.list[].department_idobject[]部门id
member_replyobject成员题答案
member_reply.listobject[]成员选择的成员列表
member_reply.list[].useridobject[]成员id
duration_replyobject时长题答案
duration_reply.begin_timeuint32开始时间,时间戳
duration_reply.end_timeuint32结束时间,时间戳
duration_reply.time_scaleuint32时间刻度。1: 按天 2: 按小时
duration_reply.day_rangeuint32单位换算,多少小时/天。time_scale2返回
duration_reply.daysfloat天数。time_scale1返回
duration_reply.hoursfloat小时数。time_scale2返回
answer_statusuint32答案状态 1:正常 3:统计者移除此答案或删除
tmp_external_useridstring外部用户临时id,匿名填写不返回,同一个用户在不同的收集表中返回的该id不一致。
可进一步通过tmp_external_userid的转换接口转换成外部联系人的external_userid,方便识别外部填写人的身份。
useridstring用户id,匿名填写不返回
上一篇
收集表的统计信息查询
下一篇
编辑文档内容