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>参见 <a href="https://www.showdoc.com.cn/wjxopenapi/7565538864916202" title="3.2问卷类型">3.2问卷类型</a></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:仅获取主账户的问卷<br><strong>·</strong>“1”或true:获取企业的所有问卷<br><strong>·</strong> 仅在creater为主账户时有效<br><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:获取星标与非星标问卷<br><strong>·</strong>“1”或true:仅获取星标问卷<br><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>不能包含特殊字符<br>精确匹配问卷名中包含模糊关键字的问卷<br>长度不超过10个字母或汉字</td>
</tr>
<tr>
<td style="text-align: left;">status</td>
<td style="text-align: left;">问卷状态</td>
<td>int</td>
<td>否</td>
<td>获取指定状态的问卷,详细定义见:<a href="https://www.showdoc.com.cn/wjxopenapi/7570081285284591" title="3.8问卷状态">3.8问卷状态</a></td>
</tr>
<tr>
<td style="text-align: left;">verify_status</td>
<td style="text-align: left;">问卷审核状态</td>
<td>int</td>
<td>否</td>
<td>获取指定审核状态的问卷,详细定义见:<a href="https://www.showdoc.com.cn/wjxopenapi/7570087274343842" title="3.9问卷审核状态">3.9问卷审核状态</a></td>
</tr>
<tr>
<td style="text-align: left;">time_type</td>
<td style="text-align: left;">按时间查询类型</td>
<td>int</td>
<td>否</td>
<td>默认为0<br>0:不按时间查询<br>1:按问卷开始时间<br>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:问卷编号升序<br>1:问卷编号降序<br>2:问卷开始时间升序<br>3:问卷开始时间降序<br>4:问卷创建时间升序<br>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分页,当jid或sojumpparm有值时,将返回全部查询结果</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
{
"encode": "sha1",
"creater": "xiajinhu",
"appid": "907",
"sign": "d2050d70204bc2fd98e60cfe34cd6f2501500078",
"action": "1000002",
"ts": 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:问卷编号升序<br>1:问卷编号降序<br>2:问卷开始时间升序<br>3:问卷开始时间降序</td>
</tr>
<tr>
<td style="text-align: left;">activitys</td>
<td style="text-align: left;">Dictionary<int, activity></td>
<td>问卷列表</td>
<td>是 主</td>
<td>键为问卷编号,值为问卷信息<br>参见:2.1.2.2.1 <a href="#2.1.1.6.1">2.1.2.2.1答卷对象参数(activity)</a></td>
</tr>
</tbody>
</table>
<div id = "2.1.2.2.1"></div>
<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>参见<a href="https://www.showdoc.com.cn/wjxopenapi/7565538864916202" title="3.2 问卷类型">3.2 问卷类型</a></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>参见<a href="https://www.showdoc.com.cn/wjxopenapi/7570081285284591" title="3.8 问卷状态">3.8 问卷状态</a></td>
</tr>
<tr>
<td style="text-align: left;">verify_status</td>
<td style="text-align: left;">int</td>
<td>问卷审核状态</td>
<td>是</td>
<td>参见<a href="https://www.showdoc.com.cn/wjxopenapi/7570087274343842" title="3.9 问卷审核状态">3.9 问卷审核状态</a></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">{
"result": true,
"data": {
"page_index": 1,
"page_size": 10,
"total_count": 455,
"sort": 0,
"activitys": {
"123": {
"vid": 123,
"sid": "123",
"atype": 1,
"title": "调查1",
"status": 4,
"verify_status": 2,
"answer_valid": 0,
"answer_total": 0,
"begin_date": "2019-01-22 11:36:12",
"create_date": "2019-01-22 11:36:12",
"creater": "xia",
"activity_domain": "https://www.wjx.cn",
"pc_path": "/jq/123..aspx",
"mobile_path": "/m/123..aspx",
"iframe_auto_url": "<script type='text/javascript' src='https://www.wjx.cn/handler/jqemed.ashx?activity=123&width=760&source=iframe'></script>",
"iframe_noauto_url": "<iframe src='https://www.wjx.cn/jq/123.aspx?width=760&source=iframe&s=t' width='799' height='800' frameborder='0' style='overflow:auto'></iframe>"
},
"456": {
"vid": 456,
"sid": "456",
"atype": 1,
"title": "调查1",
"status": 4,
"verify_status": 2,
"answer_valid": 0,
"answer_total": 0,
"begin_date": "2019-01-22 11:37:32",
"create_date": "2019-01-22 11:37:32",
"creater": "xia",
"activity_domain": "https://www.wjx.cn",
"pc_path": "/jq/456..aspx",
"mobile_path": "/m/456..aspx",
"iframe_auto_url": "<script type='text/javascript' src='https://www.wjx.cn/handler/jqemed.ashx?activity=456&width=760&source=iframe'></script>",
"iframe_noauto_url": "<iframe src='https://www.wjx.cn/jq/456.aspx?width=760&source=iframe&s=t' width='799' height='800' frameborder='0' style='overflow:auto'></iframe>"
},
"789": {
"vid": 789,
"sid": "789",
"atype": 1,
"title": "调查1",
"status": 4,
"verify_status": 2,
"answer_valid": 0,
"answer_total": 0,
"begin_date": "2019-01-22 11:38:16",
"create_date": "2019-01-22 11:38:16",
"creater": "xia",
"activity_domain": "https://www.wjx.cn",
"pc_path": "/jq/789..aspx",
"mobile_path": "/m/789..aspx",
"iframe_auto_url": "<script type='text/javascript' src='https://www.wjx.cn/handler/jqemed.ashx?activity=789&width=760&source=iframe'></script>",
"iframe_noauto_url": "<iframe src='https://www.wjx.cn/jq/789.aspx?width=760&source=iframe&s=t' width='799' height='800' frameborder='0' style='overflow:auto'></iframe>"
}
}
}
}</code></pre>