问卷星开放文档

问卷星开放文档


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&lt;int, activity&gt;</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": "&lt;script type='text/javascript' src='https://www.wjx.cn/handler/jqemed.ashx?activity=123&amp;width=760&amp;source=iframe'&gt;&lt;/script&gt;", "iframe_noauto_url": "&lt;iframe src='https://www.wjx.cn/jq/123.aspx?width=760&amp;source=iframe&amp;s=t' width='799' height='800' frameborder='0' style='overflow:auto'&gt;&lt;/iframe&gt;" }, "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": "&lt;script type='text/javascript' src='https://www.wjx.cn/handler/jqemed.ashx?activity=456&amp;width=760&amp;source=iframe'&gt;&lt;/script&gt;", "iframe_noauto_url": "&lt;iframe src='https://www.wjx.cn/jq/456.aspx?width=760&amp;source=iframe&amp;s=t' width='799' height='800' frameborder='0' style='overflow:auto'&gt;&lt;/iframe&gt;" }, "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": "&lt;script type='text/javascript' src='https://www.wjx.cn/handler/jqemed.ashx?activity=789&amp;width=760&amp;source=iframe'&gt;&lt;/script&gt;", "iframe_noauto_url": "&lt;iframe src='https://www.wjx.cn/jq/789.aspx?width=760&amp;source=iframe&amp;s=t' width='799' height='800' frameborder='0' style='overflow:auto'&gt;&lt;/iframe&gt;" } } } }</code></pre>

页面列表

ITEM_HTML