2.2.2 答卷查询[1001002]
<p>[TOC]</p>
<h1>接口地址</h1>
<p>生产环境：<code>https://www.wjx.cn/openapi/default.aspx</code>
注：已自定义域名的用户，请将www.wjx.cn换成自定义域名</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>单个链接参数字符串长度不大于100，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 GMT起至现在的总毫秒数）</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 GMT起至现在的总毫秒数）</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>
<tr>
<td style="text-align: left;">distinct_user</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>
<tr>
<td style="text-align: left;">distinct_sojumpparm</td>
<td style="text-align: left;">bool</td>
<td>是否仅自定义参数<br/>最新答卷</td>
<td>否</td>
<td><strong>·</strong>“0”或false：不获取<br><strong>·</strong>“1”或true：获取<br><strong>·</strong> 默认为false<br/>当distinct_user也为true时，distinct_sojumpparm不生效</td>
</tr>
<tr>
<td style="text-align: left;">conds</td>
<td style="text-align: left;">json string<br>(condition[])</td>
<td>题目查询条件</td>
<td>否</td>
<td><strong>·</strong> 题目查询对象：<a href="#2.2.2.1.1">2.2.2.1.1 题目查询条件（condition）</a><br><strong>·</strong> 需要将condition[]对象转为json string<br> <strong>·</strong> 最多支持2个组合条件；<br><strong>·</strong> 组合条件之间的逻辑关系为AND；<br>目前支持以下类型：<br><strong>·</strong> 选择类：单选题、下拉题、多选题、量表题；<br><strong>·</strong> 文本类：填空题、多项填空题、文件上传题<br><strong>·</strong> 数值类：比重题、滑动条题、文本验证类型为数值或时间的题；<br> <strong>·</strong> 总长度不能超过200个字符<br/></td>
</tr>
</tbody>
</table>
<p><div id="2.2.2.1.1"></div>2.2.2.1.1 题目查询条件（condition）</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;">q_index</td>
<td style="text-align: left;">int</td>
<td>题目编号</td>
<td>是</td>
<td>题目编号的取值请参考查询答卷内容中返回的题目编号（answer_items节点的主键）<a href="#2.2.2.2.1 答卷对象参数（answer）">2.2.2.2.1 答卷对象参数（answer）</a><br/></td>
</tr>
<tr>
<td style="text-align: left;">opt</td>
<td style="text-align: left;">string</td>
<td>操作符</td>
<td>是</td>
<td><strong>·</strong> 选择类操作："=", "!=", "in"<br/> <strong>·</strong> 文本类操作："=", "!=", "like", "not like"<br/> <strong>·</strong> 数值/时间类操作："=", "!=", ">", "<", ">=", "<=", "between" <br/></td>
</tr>
<tr>
<td style="text-align: left;">val</td>
<td style="text-align: left;">string</td>
<td>查询值</td>
<td>是</td>
<td>选择类：<br/><strong>·</strong> 查询值为选项编号<br/> <strong>·</strong> -2 空 -3 跳过<br/> <strong>·</strong> 操作符为"in"时，支持多个选项，使用","分隔<br/> 文本类：<br/><strong>·</strong> 不能包含数据库敏感字符<br/> <strong>·</strong> 字符长度不能超过50个字符 <br/><strong>·</strong> 文本中支持使用&丨(优先&运算)来完成逻辑查询，A丨B&C丨D表示：<code>AND (A OR B) AND (C OR D)</code> <br/> 数值/时间类：<br/><strong>·</strong> 查询值必须为数字或时间<br/> <strong>·</strong> 操作符为"between"时，最小最大值使用","分隔，取前者为最小值，取后者为最大值<br/></td>
</tr>
</tbody>
</table>
<ul>
<li>举例：
<pre><code class="language-csharp">Content-Type:application/json
{
&quot;encode&quot;: &quot;sha1&quot;,
&quot;vid&quot;: &quot;104356&quot;,
&quot;appid&quot;: &quot;907&quot;,
&quot;sign&quot;: &quot;d2050d70204bc2fd98e60cfe34cd6f2501500078&quot;,
&quot;action&quot;: &quot;1001002&quot;,
&quot;ts&quot;: 1583812686
}</code></pre></li>
<li>题目查询条件举例：
<pre><code class="language-csharp">{
&quot;action&quot;: &quot;1001002&quot;,
&quot;appid&quot;: &quot;907&quot;,
&quot;conds&quot;: &quot;[{\&quot;q_index\&quot;: 10000,\&quot;opt\&quot;: \&quot;in\&quot;,\&quot;val\&quot;:\&quot;1,2\&quot;}]&quot;,
&quot;encode&quot;: &quot;sha1&quot;,
&quot;sign&quot;: &quot;4b43b543ff5d40fd06fd37b5d5e939a68db16e27&quot;,
&quot;ts&quot;: &quot;1717488416&quot;,
&quot;vid&quot;: &quot;257868478&quot;
}</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;">Dictionary<long, <a href="#2.2.2.2.1 answer">answer</a>></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>