2.2.4 答卷下载[1001004]
<p>[TOC]</p>
<h1>接口地址</h1>
<p>生产环境：<code>https://www.wjx.cn/openapi/default.aspx</code></p>
<ul>
<li>
<h1>2.2.4.1请求参数格式</h1>
</li>
</ul>
<table>
<thead>
<tr>
<th style="text-align: left;">参数</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
<th>必需</th>
<th>备注</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">vid</td>
<td style="text-align: left;">int</td>
<td>问卷编号</td>
<td>是</td>
<td>问卷星发送问卷链接中activityid的值</td>
</tr>
<tr>
<td style="text-align: left;">taskid</td>
<td style="text-align: left;">int</td>
<td>任务编号</td>
<td>否</td>
<td>转为异步下载时返回的任务编号，此参数主要用于轮询异步下载任务是否完成。存在taskid时，其他查询参数均以生成任务时的查询参数为准；</td>
</tr>
<tr>
<td style="text-align: left;">valid</td>
<td style="text-align: left;">bool</td>
<td>查询有效答卷</td>
<td>否</td>
<td>“0”或false：查询无效答卷<br>“1”或true：查看有效答卷<br>默认为true<br>sav格式暂时仅支持下载有效答卷</td>
</tr>
<tr>
<td style="text-align: left;">query_count</td>
<td style="text-align: left;">int</td>
<td>查询的最大答卷条数</td>
<td>否</td>
<td>如果问卷的答卷数大于3000，可以通过定义这个参数来多次同步获取答卷</td>
</tr>
<tr>
<td style="text-align: left;">begin_time</td>
<td style="text-align: left;">long</td>
<td>查询开始时间截（含节点时间）</td>
<td>否</td>
<td>查询此时间截以后完成的问卷Unix时间戳（格林威治时间1970年01月01日00时00分00秒起至现在的总毫秒数）</td>
</tr>
<tr>
<td style="text-align: left;">end_time</td>
<td style="text-align: left;">long</td>
<td>查询结束时间截（不含节点时间）</td>
<td>否</td>
<td>查询此时间截以前完成的问卷Unix时间戳（格林威治时间1970年01月01日00时00分00秒起至现在的总毫秒数）</td>
</tr>
<tr>
<td style="text-align: left;">min_index</td>
<td style="text-align: left;">long</td>
<td>最小答卷序号</td>
<td>否</td>
<td>查询返回大于最小答卷序号的答卷</td>
</tr>
<tr>
<td style="text-align: left;">sort</td>
<td style="text-align: left;">int</td>
<td>排序规则</td>
<td>否</td>
<td>0：升序<br>1：降序<br>默认为0</td>
</tr>
</tbody>
</table>
<p>内容相关参数</p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
<th>必需</th>
<th>备注</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">query_type</td>
<td style="text-align: left;">int</td>
<td>查询方式</td>
<td>否</td>
<td>0：按选项文本下载<br>1：按选项分数下载<br>2：按序号下载<br>默认为0<br>sav格式仅支持2：按选项序号下载</td>
</tr>
<tr>
<td style="text-align: left;">suffix</td>
<td style="text-align: left;">int</td>
<td>下载文件格式</td>
<td>否</td>
<td>0:csv <br>1:sav<br>2:word<br>默认为0</td>
</tr>
<tr>
<td style="text-align: left;">query_record</td>
<td style="text-align: left;">bool</td>
<td>仅查询参与作答记录</td>
<td>否</td>
<td>“0”或false：查询完整作答信息，如果查询到的答卷数大于3000，将转为下载任务并返回任务编号；用户系统需用户任务编号来轮询下载结果；“1”或true：仅查询参与作答记录，不限制答卷数<br>默认为false</td>
</tr>
</tbody>
</table>
<ul>
<li>举例
<pre><code class="language-csharp">Content-Type:application/json
{
"encode": "sha1",
"vid": "104356",
"appid": "907",
"sign": "d2050d70204bc2fd98e60cfe34cd6f2501500078",
"action": "1001004",
"ts": 1583812686
}</code></pre></li>
</ul>
<h1>2.2.4.2响应参数列表</h1>
<table>
<thead>
<tr>
<th style="text-align: left;">参数</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
<th>必需</th>
<th>备注</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">vid</td>
<td style="text-align: left;">int</td>
<td>问卷编号</td>
<td>是</td>
</tr>
<tr>
<td style="text-align: left;">status</td>
<td style="text-align: left;">int</td>
<td>数据生成状态</td>
<td>是</td>
<td><strong>·</strong> 0：未完成<br><strong>·</strong> 1：已完成</td>
</tr>
<tr>
<td style="text-align: left;">valid</td>
<td style="text-align: left;">bool</td>
<td>查询有效答卷</td>
<td>是</td>
</tr>
<tr>
<td style="text-align: left;">query_type</td>
<td style="text-align: left;">int</td>
<td>查询方式</td>
<td>是</td>
<td><strong>·</strong> 0：按选项文本下载<br><strong>·</strong> 1：按选项分数下载<br><strong>·</strong> 2：按序号下载</td>
</tr>
<tr>
<td style="text-align: left;">join_times</td>
<td style="text-align: left;">int</td>
<td>问卷总答卷数</td>
<td>是</td>
</tr>
<tr>
<td style="text-align: left;">download_url</td>
<td style="text-align: left;">string</td>
<td>答卷下载地址</td>
<td>是</td>
<td><strong>·</strong> 接口会根据查询条件查询符合条件的所有答卷并生成为一个csv文件，此链接为文件的下载地址；<br><strong>·</strong> 当且仅当status为1时有效；<br><strong>·</strong> 链接有效为24小时；<br><strong>·</strong> 查询条件相同的情况下，会返回缓存数据，缓存有效期为60秒；</td>
</tr>
<tr>
<td style="text-align: left;">taskid</td>
<td style="text-align: left;">int</td>
<td>任务编号</td>
<td>否</td>
<td>转为异步下载时返回的任务编号，此参数主要用于轮询异步下载任务是否完成。</td>
</tr>
</tbody>
</table>