2.2.2 答卷查询[1001002]
<p>[TOC]</p>
<h1>接口地址</h1>
<p>生产环境：<code>https://www.wjx.cn/openapi/default.aspx</code></p>
<ul>
<li>
<h1>2.2.2.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;">valid</td>
<td style="text-align: left;">bool</td>
<td>查询有效答卷</td>
<td>否</td>
<td>true：查询有效答卷<br>false：查看无效答卷<br>默认为true</td>
</tr>
<tr>
<td style="text-align: left;">page_index</td>
<td style="text-align: left;">int</td>
<td>分页页码</td>
<td>否</td>
<td>默认值为1，即返回第1分页<br>当jid或sojumpparm有值时，将返回全部查询结果</td>
</tr>
<tr>
<td style="text-align: left;">page_size</td>
<td style="text-align: left;">int</td>
<td>每页答卷数</td>
<td>否</td>
<td>默认分页数为10，最大分页数为50，超过最大分页数时，使用默认分页数10;</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>默认为升序排序</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;">jid</td>
<td style="text-align: left;">long</td>
<td>答卷编号</td>
<td>否</td>
<td>多个答卷编号使用”,”号分隔<br>最多传入50个；</td>
</tr>
<tr>
<td style="text-align: left;">sojumpparm</td>
<td style="text-align: left;">string</td>
<td>问卷自定义链接参数</td>
<td>否</td>
<td>多个参数使用”,”号分隔；<br>单个链接参数字符串长度不大于50，sojumpparm不能包含数据库的特殊字符；<br>最多传入50个；</td>
</tr>
<tr>
<td style="text-align: left;">qid</td>
<td style="text-align: left;">string</td>
<td>指定问题列表</td>
<td>否</td>
<td>多个参数使用”,”号分隔；<br>最多传入50个;<br>列表中罗列需要返回答案的题号，指定问题列表后，仅返回相应的问卷答案；<br>传入不存在的题号将会被忽略，为空时，返回全部题目；</td>
</tr>
<tr>
<td style="text-align: left;">begin_time</td>
<td style="text-align: left;">long</td>
<td>查询开始时间截（含节点时间）</td>
<td>否</td>
<td>查询此时间截以后完成的问卷<br>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>查询此时间截以前完成的问卷<br>Unix时间戳（格林威治时间1970年01月01日00时00分00秒起至现在的总毫秒数）</td>
</tr>
<tr>
<td style="text-align: left;">file_view_expires</td>
<td style="text-align: left;">int</td>
<td>文件上传题链接有效期（小时）</td>
<td>否</td>
<td>1、查询文件上传题时，生成的文件访问链接有效期；<br>2、默认值为1，即有效期为1小时；<br>3、可使用接口刷新文件访问链接；</td>
</tr>
<tr>
<td style="text-align: left;">query_note</td>
<td style="text-align: left;">bool</td>
<td>是否查询标注信息</td>
<td>否</td>
<td><strong>·</strong>“0”或false：不获取<br><strong>·</strong>“1”或true：获取<br><strong>·</strong> 默认为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": "1001002",
"ts": 1583812686
}</code></pre></li>
<li>
<h1>2.2.2.2 响应参数列表</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>
</tr>
<tr>
<td style="text-align: left;">valid</td>
<td style="text-align: left;">bool</td>
<td>查询有效答卷</td>
<td>是</td>
<td>按请求返回</td>
</tr>
<tr>
<td style="text-align: left;">page_index</td>
<td style="text-align: left;">int</td>
<td>分页页码</td>
<td>是</td>
</tr>
<tr>
<td style="text-align: left;">page_size</td>
<td style="text-align: left;">int</td>
<td>每页答卷数</td>
<td>是</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;">total_count</td>
<td style="text-align: left;">int</td>
<td>当前查询条件下的总答卷数</td>
<td>是</td>
</tr>
<tr>
<td style="text-align: left;">answers</td>
<td style="text-align: left;">answer[]</td>
<td>答卷列表</td>
<td>是</td>
</tr>
</tbody>
</table>
<h2>2.2.2.2.1 答卷对象参数（answer）</h2>
<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;">index</td>
<td style="text-align: left;">long</td>
<td>答卷序号</td>
<td>是</td>
</tr>
<tr>
<td style="text-align: left;">jid</td>
<td style="text-align: left;">long</td>
<td>答卷编号</td>
<td>是</td>
</tr>
<tr>
<td style="text-align: left;">submit_time</td>
<td style="text-align: left;">string</td>
<td>提交答卷时间</td>
<td>是</td>
</tr>
<tr>
<td style="text-align: left;">answer_seconds</td>
<td style="text-align: left;">int</td>
<td>问卷作答用时</td>
<td>是</td>
<td>单位为秒</td>
</tr>
<tr>
<td style="text-align: left;">source</td>
<td style="text-align: left;">string</td>
<td>作答来源</td>
<td>是</td>
</tr>
<tr>
<td style="text-align: left;">source_detail</td>
<td style="text-align: left;">string</td>
<td>来源详情</td>
<td>是</td>
<td>自定义链接参数sojumpparm会记录到这个字段</td>
</tr>
<tr>
<td style="text-align: left;">source_ip</td>
<td style="text-align: left;">string</td>
<td>来源IP</td>
<td>是</td>
</tr>
<tr>
<td style="text-align: left;">province</td>
<td style="text-align: left;">string</td>
<td>来源省份</td>
<td>是</td>
</tr>
<tr>
<td style="text-align: left;">city</td>
<td style="text-align: left;">string</td>
<td>来源城市</td>
<td>是</td>
</tr>
<tr>
<td style="text-align: left;">score</td>
<td style="text-align: left;">doule</td>
<td>考试分数</td>
<td>否</td>
<td>考试场景下返回有效</td>
</tr>
<tr>
<td style="text-align: left;">total_score</td>
<td style="text-align: left;">doule</td>
<td>考卷总分</td>
<td>否</td>
<td>考试场景下返回有效</td>
</tr>
<tr>
<td style="text-align: left;">answerer</td>
<td style="text-align: left;">string</td>
<td>答题者</td>
<td>是</td>
<td>1、当为用户体系问卷时，值为用户ID<br>2、当为系统用户在登录后作答时，值为用户名</td>
</tr>
<tr>
<td style="text-align: left;">is_starmark</td>
<td style="text-align: left;">bool</td>
<td>是否是星标答卷</td>
<td>是</td>
<td>是否为星标答卷<br>0：不是 1：是</td>
</tr>
<tr>
<td style="text-align: left;">note</td>
<td style="text-align: left;">string</td>
<td>答卷标识信息</td>
<td>否</td>
</tr>
<tr>
<td style="text-align: left;">answer_items</td>
<td style="text-align: left;">Dictionary<int, answer_item></td>
<td>答案选项</td>
<td>是</td>
<td>主键为题目编号，值为答案选项</td>
</tr>
</tbody>
</table>
<h2>2.2.2.2.2 题目答案对象参数（answer_item）</h2>
<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;">q_index</td>
<td style="text-align: left;">int</td>
<td>题目编号</td>
<td>是</td>
</tr>
<tr>
<td style="text-align: left;">q_row</td>
<td style="text-align: left;">int</td>
<td>题目行号</td>
<td>是</td>
</tr>
<tr>
<td style="text-align: left;">q_column</td>
<td style="text-align: left;">int</td>
<td>题目列号</td>
<td>是</td>
</tr>
<tr>
<td style="text-align: left;">title</td>
<td style="text-align: left;">string</td>
<td>题目标题</td>
<td>是</td>
</tr>
<tr>
<td style="text-align: left;">item_index</td>
<td style="text-align: left;">int[]</td>
<td>题目选项列表</td>
<td>否</td>
<td>多项选择中，返回多个值</td>
</tr>
<tr>
<td style="text-align: left;">item_value</td>
<td style="text-align: left;">double</td>
<td>题目选项分值</td>
<td>是</td>
<td>1、情景随机题型中，表示数量限制。<br>2、商品题中表示某商品的购买数量</td>
</tr>
<tr>
<td style="text-align: left;">answer_text</td>
<td style="text-align: left;">string</td>
<td>题目文本答案</td>
<td>是</td>
</tr>
<tr>
<td style="text-align: left;">files</td>
<td style="text-align: left;">string[]</td>
<td>上传的文件列表</td>
<td>否</td>
<td>仅文件上传题有效</td>
</tr>
<tr>
<td style="text-align: left;">file_download</td>
<td style="text-align: left;">string[]</td>
<td>文件上传题下载地址</td>
<td>否</td>
<td>仅文件上传题有效</td>
</tr>
<tr>
<td style="text-align: left;">file_view</td>
<td style="text-align: left;">string[]</td>
<td>文件上传题浏览地址</td>
<td>否</td>
<td>仅文件上传题有效</td>
</tr>
</tbody>
</table>