问卷星开放文档

问卷星开放文档


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:查询无效答卷&lt;br&gt;“1”或true:查看有效答卷&lt;br&gt;默认为true&lt;br&gt;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;">qid</td> <td style="text-align: left;">string</td> <td>指定问题列表</td> <td>否</td> <td>多个参数使用”,”号分隔;&lt;br&gt;最多传入50个;&lt;br&gt;列表中罗列需要返回答案的题号,指定问题列表后,仅返回相应的问卷答案;&lt;br&gt;传入不存在的题号将会被忽略,为空时,返回全部题目;</td> </tr> <tr> <td style="text-align: left;">sort</td> <td style="text-align: left;">int</td> <td>排序规则</td> <td>否</td> <td>0:升序&lt;br&gt;1:降序&lt;br&gt;默认为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:按选项文本下载&lt;br&gt;1:按选项分数下载&lt;br&gt;2:按序号下载&lt;br&gt;默认为0&lt;br&gt;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 &lt;br&gt;1:sav&lt;br&gt;2:word&lt;br&gt;默认为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:仅查询参与作答记录,不限制答卷数&lt;br&gt;默认为false</td> </tr> </tbody> </table> <ul> <li>举例 <pre><code class="language-csharp">Content-Type:application/json {     &amp;quot;encode&amp;quot;: &amp;quot;sha1&amp;quot;,     &amp;quot;vid&amp;quot;: &amp;quot;104356&amp;quot;,     &amp;quot;appid&amp;quot;: &amp;quot;907&amp;quot;,     &amp;quot;sign&amp;quot;: &amp;quot;d2050d70204bc2fd98e60cfe34cd6f2501500078&amp;quot;,     &amp;quot;action&amp;quot;: &amp;quot;1001004&amp;quot;,     &amp;quot;ts&amp;quot;: 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:未完成&lt;br&gt;<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:按选项文本下载&lt;br&gt;<strong>·</strong> 1:按选项分数下载&lt;br&gt;<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文件,此链接为文件的下载地址;&lt;br&gt;<strong>·</strong> 当且仅当status为1时有效;&lt;br&gt;<strong>·</strong> 链接有效为24小时;&lt;br&gt;<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>

页面列表

ITEM_HTML