问卷星开放文档

问卷星开放文档


2.1.2获取问卷列表[1000002]

<p>[TOC]</p> <h1>接口地址接口地址</h1> <p>生产环境:<code>https://www.wjx.cn/openapi/default.aspx</code>, 如果已经使用自定义域名,请求<code>www.wjx.cn</code> 换成相应的自定义域名。</p> <h1>2.1.2.1请求参数格式</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;">creater</td> <td style="text-align: left;">问卷发布者</td> <td>string</td> <td>否</td> <td>不填时获取主账户发布的问卷,企业微信子账户需要在子账户名前加“qw$”前缀</td> </tr> <tr> <td style="text-align: left;">vid</td> <td style="text-align: left;">问卷编号</td> <td>int</td> <td>否</td> </tr> <tr> <td style="text-align: left;">atype</td> <td style="text-align: left;">问卷类型</td> <td>int</td> <td>否</td> <td>参见 [3.2问卷类型](<a href="https://openapi.wjx.cn/web/#/5/56">https://openapi.wjx.cn/web/#/5/56</a> &quot;3.2问卷类型&quot;)</td> </tr> <tr> <td style="text-align: left;">query_all</td> <td style="text-align: left;">是否获取企业的所有问卷</td> <td>bool</td> <td>否</td> <td><strong>·</strong>“0”或false:仅获取主账户的问卷&lt;br&gt;<strong>·</strong>“1”或true:获取企业的所有问卷&lt;br&gt;<strong>·</strong> 仅在creater为主账户时有效&lt;br&gt;<strong>·</strong> 默认值为“0”,即仅获取主账户的问卷</td> </tr> <tr> <td style="text-align: left;">folder</td> <td style="text-align: left;">文件夹名</td> <td>string</td> <td>否</td> <td>获取文件夹下的问卷</td> </tr> <tr> <td style="text-align: left;">is_xingbiao</td> <td style="text-align: left;">是否是星标问卷</td> <td>bool</td> <td>否</td> <td><strong>·</strong>“0”或false:获取星标与非星标问卷&lt;br&gt;<strong>·</strong>“1”或true:仅获取星标问卷&lt;br&gt;<strong>·</strong> 默认值为“0”</td> </tr> <tr> <td style="text-align: left;">name_like</td> <td style="text-align: left;">问卷名模糊查询关键字</td> <td>string</td> <td>否</td> <td>不能包含特殊字符&lt;br&gt;精确匹配问卷名中包含模糊关键字的问卷&lt;br&gt;长度不超过10个字母或汉字</td> </tr> <tr> <td style="text-align: left;">status</td> <td style="text-align: left;">问卷状态</td> <td>int</td> <td>否</td> <td>获取指定状态的问卷,详细定义见:[3.8问卷状态](<a href="https://openapi.wjx.cn/web/#/5/62">https://openapi.wjx.cn/web/#/5/62</a> &quot;3.8问卷状态&quot;)</td> </tr> <tr> <td style="text-align: left;">verify_status</td> <td style="text-align: left;">问卷审核状态</td> <td>int</td> <td>否</td> <td>获取指定审核状态的问卷,详细定义见:[3.9问卷审核状态](<a href="https://openapi.wjx.cn/web/#/5/63">https://openapi.wjx.cn/web/#/5/63</a> &quot;3.9问卷审核状态&quot;)</td> </tr> <tr> <td style="text-align: left;">time_type</td> <td style="text-align: left;">按时间查询类型</td> <td>int</td> <td>否</td> <td>默认为0&lt;br&gt;0:不按时间查询&lt;br&gt;1:按问卷开始时间&lt;br&gt;2:按问卷创建时间</td> </tr> <tr> <td style="text-align: left;">begin_time</td> <td style="text-align: left;">查询开始时间截(含节点时间)</td> <td>long</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;">查询结束时间截(不含节点时间)</td> <td>long</td> <td>否</td> <td>查询此时间截以前的问卷,Unix时间戳(格林威治时间1970年01月01日00时00分00秒起至现在的总毫秒数)</td> </tr> <tr> <td style="text-align: left;">sort</td> <td style="text-align: left;">排序规则</td> <td>int</td> <td>否</td> <td>0:问卷编号升序&lt;br&gt;1:问卷编号降序&lt;br&gt;2:问卷开始时间升序&lt;br&gt;3:问卷开始时间降序&lt;br&gt;4:问卷创建时间升序&lt;br&gt;5:问卷创建时间降序</td> </tr> <tr> <td style="text-align: left;">page_index</td> <td style="text-align: left;">分页页码</td> <td>int</td> <td>否</td> <td>默认值为1,即返回第1分页</td> </tr> <tr> <td style="text-align: left;">page_size</td> <td style="text-align: left;">分页大小</td> <td>int</td> <td>否</td> <td>默认分页数为10,最大分页数为300,超过最大分页数时,使用默认分页数10;</td> </tr> </tbody> </table> <ul> <li>举例</li> </ul> <pre><code class="language-csharp">Content-Type:application/json {     &amp;quot;encode&amp;quot;: &amp;quot;sha1&amp;quot;,     &amp;quot;creater&amp;quot;: &amp;quot;xiajinhu&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;1000002&amp;quot;,     &amp;quot;ts&amp;quot;: 1583812686 }</code></pre> <h1>2.1.2.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;">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;">total_count</td> <td style="text-align: left;">int</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:问卷编号升序&lt;br&gt;1:问卷编号降序&lt;br&gt;2:问卷开始时间升序&lt;br&gt;3:问卷开始时间降序</td> </tr> <tr> <td style="text-align: left;">activitys</td> <td style="text-align: left;">Dictionary&lt;int, activity&gt;</td> <td>问卷列表</td> <td>是 主</td> <td>键为问卷编号,值为问卷信息&lt;br&gt;参见:2.1.2.2.1 &lt;a href=&quot;#2.1.1.6.1&quot;&gt;2.1.2.2.1答卷对象参数(activity)&lt;/a&gt;</td> </tr> </tbody> </table> <p>&lt;div id = &quot;2.1.2.2.1&quot;&gt;&lt;/div&gt;</p> <h2>2.1.2.2.1 答卷对象参数(activity)</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;">vid</td> <td style="text-align: left;">int</td> <td>问卷编号</td> <td>是</td> </tr> <tr> <td style="text-align: left;">sid</td> <td style="text-align: left;">string</td> <td>问卷短编号</td> <td>是</td> <td>sid等于vid时,表示问卷未启用短链接</td> </tr> <tr> <td style="text-align: left;">begin_date</td> <td style="text-align: left;">string</td> <td>问卷开始时间</td> <td>是</td> <td>时间格式:yyyy-MM-dd HH:mm:ss;</td> </tr> <tr> <td style="text-align: left;">create_date</td> <td style="text-align: left;">string</td> <td>问卷创建时间</td> <td>是</td> <td>时间格式:yyyy-MM-dd HH:mm:ss;</td> </tr> <tr> <td style="text-align: left;">atype</td> <td style="text-align: left;">int</td> <td>问卷类型</td> <td>是</td> <td>参见[3.2 问卷类型](<a href="https://openapi.wjx.cn/web/#/5/56">https://openapi.wjx.cn/web/#/5/56</a> &quot;3.2 问卷类型&quot;)</td> </tr> <tr> <td style="text-align: left;">folder</td> <td style="text-align: left;">string</td> <td>问卷所在文件夹</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;">creater</td> <td style="text-align: left;">string</td> <td>问卷创建者</td> <td>是</td> </tr> <tr> <td style="text-align: left;">answer_valid</td> <td style="text-align: left;">int</td> <td>有效答卷数</td> <td>是</td> </tr> <tr> <td style="text-align: left;">answer_total</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>参见[3.8 问卷状态](<a href="https://openapi.wjx.cn/web/#/5/62">https://openapi.wjx.cn/web/#/5/62</a> &quot;3.8 问卷状态&quot;)</td> </tr> <tr> <td style="text-align: left;">verify_status</td> <td style="text-align: left;">int</td> <td>问卷审核状态</td> <td>是</td> <td>参见[3.9 问卷审核状态](<a href="https://openapi.wjx.cn/web/#/5/63">https://openapi.wjx.cn/web/#/5/63</a> &quot;3.9 问卷审核状态&quot;)</td> </tr> <tr> <td style="text-align: left;">pc_path</td> <td style="text-align: left;">string</td> <td>PC端问卷Url相对路径</td> <td>是</td> </tr> <tr> <td style="text-align: left;">mobile_path</td> <td style="text-align: left;">string</td> <td>移动端问卷Url相对路径</td> <td>是</td> </tr> <tr> <td style="text-align: left;">activity_domain</td> <td style="text-align: left;">string</td> <td>问卷访问域名</td> <td>是</td> </tr> <tr> <td style="text-align: left;">iframe_auto_url</td> <td style="text-align: left;">string</td> <td>iframe自适应链接</td> <td>是</td> </tr> <tr> <td style="text-align: left;">iframe_noauto_url</td> <td style="text-align: left;">string</td> <td>iframe不自适应链接</td> <td>是</td> </tr> </tbody> </table> <ul> <li>返回示例</li> </ul> <pre><code class="language-csharp">{ &amp;quot;result&amp;quot;: true, &amp;quot;data&amp;quot;: { &amp;quot;page_index&amp;quot;: 1, &amp;quot;page_size&amp;quot;: 10, &amp;quot;total_count&amp;quot;: 455, &amp;quot;sort&amp;quot;: 0, &amp;quot;activitys&amp;quot;: { &amp;quot;123&amp;quot;: { &amp;quot;vid&amp;quot;: 123, &amp;quot;sid&amp;quot;: &amp;quot;123&amp;quot;, &amp;quot;atype&amp;quot;: 1, &amp;quot;title&amp;quot;: &amp;quot;调查1&amp;quot;, &amp;quot;status&amp;quot;: 4, &amp;quot;verify_status&amp;quot;: 2, &amp;quot;answer_valid&amp;quot;: 0, &amp;quot;answer_total&amp;quot;: 0, &amp;quot;begin_date&amp;quot;: &amp;quot;2019-01-22 11:36:12&amp;quot;, &amp;quot;create_date&amp;quot;: &amp;quot;2019-01-22 11:36:12&amp;quot;, &amp;quot;creater&amp;quot;: &amp;quot;xia&amp;quot;, &amp;quot;activity_domain&amp;quot;: &amp;quot;https://www.wjx.cn&amp;quot;, &amp;quot;pc_path&amp;quot;: &amp;quot;/jq/123..aspx&amp;quot;, &amp;quot;mobile_path&amp;quot;: &amp;quot;/m/123..aspx&amp;quot;, &amp;quot;iframe_auto_url&amp;quot;: &amp;quot;&amp;lt;script type=&amp;#039;text/javascript&amp;#039; src=&amp;#039;https://www.wjx.cn/handler/jqemed.ashx?activity=123&amp;amp;width=760&amp;amp;source=iframe&amp;#039;&amp;gt;&amp;lt;/script&amp;gt;&amp;quot;, &amp;quot;iframe_noauto_url&amp;quot;: &amp;quot;&amp;lt;iframe src=&amp;#039;https://www.wjx.cn/jq/123.aspx?width=760&amp;amp;source=iframe&amp;amp;s=t&amp;#039; width=&amp;#039;799&amp;#039; height=&amp;#039;800&amp;#039; frameborder=&amp;#039;0&amp;#039; style=&amp;#039;overflow:auto&amp;#039;&amp;gt;&amp;lt;/iframe&amp;gt;&amp;quot; }, &amp;quot;456&amp;quot;: { &amp;quot;vid&amp;quot;: 456, &amp;quot;sid&amp;quot;: &amp;quot;456&amp;quot;, &amp;quot;atype&amp;quot;: 1, &amp;quot;title&amp;quot;: &amp;quot;调查1&amp;quot;, &amp;quot;status&amp;quot;: 4, &amp;quot;verify_status&amp;quot;: 2, &amp;quot;answer_valid&amp;quot;: 0, &amp;quot;answer_total&amp;quot;: 0, &amp;quot;begin_date&amp;quot;: &amp;quot;2019-01-22 11:37:32&amp;quot;, &amp;quot;create_date&amp;quot;: &amp;quot;2019-01-22 11:37:32&amp;quot;, &amp;quot;creater&amp;quot;: &amp;quot;xia&amp;quot;, &amp;quot;activity_domain&amp;quot;: &amp;quot;https://www.wjx.cn&amp;quot;, &amp;quot;pc_path&amp;quot;: &amp;quot;/jq/456..aspx&amp;quot;, &amp;quot;mobile_path&amp;quot;: &amp;quot;/m/456..aspx&amp;quot;, &amp;quot;iframe_auto_url&amp;quot;: &amp;quot;&amp;lt;script type=&amp;#039;text/javascript&amp;#039; src=&amp;#039;https://www.wjx.cn/handler/jqemed.ashx?activity=456&amp;amp;width=760&amp;amp;source=iframe&amp;#039;&amp;gt;&amp;lt;/script&amp;gt;&amp;quot;, &amp;quot;iframe_noauto_url&amp;quot;: &amp;quot;&amp;lt;iframe src=&amp;#039;https://www.wjx.cn/jq/456.aspx?width=760&amp;amp;source=iframe&amp;amp;s=t&amp;#039; width=&amp;#039;799&amp;#039; height=&amp;#039;800&amp;#039; frameborder=&amp;#039;0&amp;#039; style=&amp;#039;overflow:auto&amp;#039;&amp;gt;&amp;lt;/iframe&amp;gt;&amp;quot; }, &amp;quot;789&amp;quot;: { &amp;quot;vid&amp;quot;: 789, &amp;quot;sid&amp;quot;: &amp;quot;789&amp;quot;, &amp;quot;atype&amp;quot;: 1, &amp;quot;title&amp;quot;: &amp;quot;调查1&amp;quot;, &amp;quot;status&amp;quot;: 4, &amp;quot;verify_status&amp;quot;: 2, &amp;quot;answer_valid&amp;quot;: 0, &amp;quot;answer_total&amp;quot;: 0, &amp;quot;begin_date&amp;quot;: &amp;quot;2019-01-22 11:38:16&amp;quot;, &amp;quot;create_date&amp;quot;: &amp;quot;2019-01-22 11:38:16&amp;quot;, &amp;quot;creater&amp;quot;: &amp;quot;xia&amp;quot;, &amp;quot;activity_domain&amp;quot;: &amp;quot;https://www.wjx.cn&amp;quot;, &amp;quot;pc_path&amp;quot;: &amp;quot;/jq/789..aspx&amp;quot;, &amp;quot;mobile_path&amp;quot;: &amp;quot;/m/789..aspx&amp;quot;, &amp;quot;iframe_auto_url&amp;quot;: &amp;quot;&amp;lt;script type=&amp;#039;text/javascript&amp;#039; src=&amp;#039;https://www.wjx.cn/handler/jqemed.ashx?activity=789&amp;amp;width=760&amp;amp;source=iframe&amp;#039;&amp;gt;&amp;lt;/script&amp;gt;&amp;quot;, &amp;quot;iframe_noauto_url&amp;quot;: &amp;quot;&amp;lt;iframe src=&amp;#039;https://www.wjx.cn/jq/789.aspx?width=760&amp;amp;source=iframe&amp;amp;s=t&amp;#039; width=&amp;#039;799&amp;#039; height=&amp;#039;800&amp;#039; frameborder=&amp;#039;0&amp;#039; style=&amp;#039;overflow:auto&amp;#039;&amp;gt;&amp;lt;/iframe&amp;gt;&amp;quot; } } } }</code></pre>

页面列表

ITEM_HTML