问卷星开放文档

问卷星开放文档


2.1.1获取问卷内容[1000001]

<p>[TOC]</p> <h1>接口地址</h1> <p>生产环境:<code>https://www.wjx.cn/openapi/default.aspx</code> 如果已经使用自定义域名,请求<code>www.wjx.cn</code> 换成相应的自定义域名;</p> <ul> <li> <h1>2.1.1.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;">get_questions</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> 默认为true</td> </tr> <tr> <td style="text-align: left;">get_items</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> 默认为true</td> </tr> <tr> <td style="text-align: left;">get_exts</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;">get_setting</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;">get_page_cut</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;">get_simple_return</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<br><strong>·</strong> 传“1”或true时:参数<code>get_questions</code>、<code>get_items</code>、<br><code>get_exts</code>、<code>get_setting</code>、<code>get_page_cut</code>失效</td> </tr> <tr> <td style="text-align: left;">get_json</td> <td style="text-align: left;">bool</td> <td>data数据是否返回json格式</td> <td>否</td> <td><strong>·</strong> 仅<code>get_simple_return</code>为true时生效<br><strong>·</strong>“0”或false:不返回json<br><strong>·</strong>“1”或true:返回 <br><strong>·</strong> 默认为false</td> </tr> <tr> <td style="text-align: left;">showtitle</td> <td style="text-align: left;">string</td> <td>是否返回问卷标题</td> <td>否</td> <td><strong>·</strong> 仅<code>get_json</code>为true时有效<br><strong>·</strong>“0”:不返回<br><strong>·</strong>“1”:返回 <br><strong>·</strong> 默认为“0”</td> </tr> </tbody> </table> <ul> <li>举例1(完整模式-<a href="#fhsl.1">返回示例</a>)</li> </ul> <pre><code class="language-csharp">Content-Type:application/json {     "encode": "sha1",     "vid": "91432",     "appid": "907",     "sign": "d2050d70204bc2fd98e60cfe34cd6f2501500078",     "action": "1000001",     "ts": 1583812686 }</code></pre> <ul> <li> <h1>2.1.1.2 响应参数列表</h1> </li> <li> <h2>2.1.1.2.1完整模式</h2> </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></td> </tr> <tr> <td style="text-align: left;">begin_time</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;">update_time</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;">version</td> <td style="text-align: left;">int</td> <td>问卷版本</td> <td>是</td> <td>数值递增</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;">title</td> <td style="text-align: left;">string</td> <td>问卷名称</td> <td>是</td> <td></td> </tr> <tr> <td style="text-align: left;">description</td> <td style="text-align: left;">string</td> <td>问卷描述</td> <td>是</td> <td></td> </tr> <tr> <td style="text-align: left;">compress_img</td> <td style="text-align: left;">bool</td> <td>是否图片压缩</td> <td>否</td> <td>默认为false</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;">answer_valid</td> <td style="text-align: left;">int</td> <td>有效答卷数</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> <td></td> </tr> <tr> <td style="text-align: left;">questions</td> <td style="text-align: left;">question[]</td> <td>题目列表</td> <td>否</td> <td><strong>·</strong> 参见<a href="#2.1.1.5">2.1.1.5题目对象参数(question)</a><br><strong>·</strong> get_questions为false时为空 <br><strong>·</strong> 题目列表按问卷设计的题目顺序依次排列</td> </tr> <tr> <td style="text-align: left;">q_extractions</td> <td style="text-align: left;">Dictionary&lt;int, qextraction&gt;</td> <td>题目扩展信息</td> <td>否</td> <td><strong>·</strong> 主键为题目编号<br><strong>·</strong> 值为答案对应题目扩展选项<br><strong>·</strong> 属性参见 <a href="#2.1.2.7">2.1.2.7 题目扩展对象(qextraction)</a><br><strong>·</strong> get_exts为false时,值为空</td> </tr> </tbody> </table> <ul> <li> <h2>2.1.1.2.2简洁模式</h2> </li> </ul> <p>参数get_json=false时</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;">data</td> <td style="text-align: left;">string</td> <td>问卷内容</td> <td>是</td> <td></td> </tr> </tbody> </table> <p>get_json=false</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;">Title</td> <td style="text-align: left;">string</td> <td>问卷标题</td> <td>否</td> <td>showtitle=1时返回</td> </tr> <tr> <td style="text-align: left;">Questions</td> <td style="text-align: left;">Questionaire</td> <td>问卷内容</td> <td>是</td> <td><a href="#2.1.2.8">Questionaire类型参考2.1.2.8</a></td> </tr> </tbody> </table> <ul> <li> <p>举例2(简洁模式-<a href="#fhsl.2">返回示例</a>)</p> <pre><code class="language-csharp">Content-Type:application/json { "encode": "sha1", "vid": "108169", "appid": "907", "sign": "d2050d70204bc2fd98e60cfe34cd6f2501500078", "action": "1000001", "get_simple_return":true, "ts": 1583812686 }</code></pre> </li> <li>举例3(简洁模式-<a href="#fhsl.3">返回示例</a>) <pre><code class="language-csharp">Content-Type:application/json { "encode": "sha1", "vid": "108169", "appid": "907", "sign": "d2050d70204bc2fd98e60cfe34cd6f2501500078", "action": "1000001", "get_simple_return":true, "get_json":true, "showtitle":"1", "ts": 1583812686 }</code></pre></li> </ul> <p>get_simple_return为true返回序号解释:(<a href="#fhsl.2">返回示例</a>)</p> <ol> <li>q1、q2、q3以此类推,代表每个题目的题干文字。</li> <li>选择类的题目,q1#1、q1#2、q1#3分别代表第一个题的第一个、第二个、第三个选项。</li> <li>多项填空题,只提供题干整体文本。</li> <li>如果是矩阵单选或矩阵多选题,q1是题干文本,q1_1,q1_2是矩阵题的第一个、第二个左行标题,q1_1#1,q1_1#2分别是矩阵题第一个左行标题的,第一个选项、第二个选项内容。</li> <li>矩阵填空,数据推送的时候直接推送的是选项内容,无需获取选项文本。类似的还有矩阵滑动条、表格下拉框、表格数值、表格文本题。</li> <li>考试问卷,不包含正确答案的信息。</li> </ol> <ul> <li> <h1>2.1.1.3 分页参数(page)</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;">q_index</td> <td style="text-align: left;">int</td> <td>分页编号</td> <td>是</td> <td></td> </tr> <tr> <td style="text-align: left;">q_type</td> <td style="text-align: left;">int</td> <td>题目类型</td> <td>是</td> <td>参见<a href="https://www.showdoc.com.cn/wjxopenapi/7569895747572645" title="3.3题目类型">3.3题目类型</a></td> </tr> <tr> <td style="text-align: left;">is_zhenbie</td> <td style="text-align: left;">bool</td> <td>是否是甄别页</td> <td>否</td> <td>默认为false</td> </tr> <tr> <td style="text-align: left;">min_time</td> <td style="text-align: left;">int</td> <td>最短填写时间,单位为秒</td> <td>否</td> <td>默认为0</td> </tr> <tr> <td style="text-align: left;">max_time</td> <td style="text-align: left;">int</td> <td>最长填写时间,单位为秒</td> <td>否</td> <td>默认为0</td> </tr> </tbody> </table> <ul> <li> <h1>2.1.1.4 段落参数(cut)</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;">q_index</td> <td style="text-align: left;">int</td> <td>题目编号</td> <td>是</td> <td></td> </tr> <tr> <td style="text-align: left;">q_type</td> <td style="text-align: left;">int</td> <td>题目类型</td> <td>是</td> <td>参见<a href="https://www.showdoc.com.cn/wjxopenapi/7569895747572645" title="3.3题目类型">3.3题目类型</a></td> </tr> <tr> <td style="text-align: left;">q_title</td> <td style="text-align: left;">string</td> <td>问题标题</td> <td>是</td> <td></td> </tr> </tbody> </table> <div id = "2.1.1.5"></div> <ul> <li> <h1>2.1.1.5 题目对象参数(question)</h1> </li> </ul> <h2>2.1.1.5.1 通用题目属性(所有题型均包含此属性)</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> <td></td> </tr> <tr> <td style="text-align: left;">q_type</td> <td style="text-align: left;">int</td> <td>题目类型</td> <td>是</td> <td>参见<a href="https://www.showdoc.com.cn/wjxopenapi/7569895747572645" title="3.3题目类型">3.3题目类型</a></td> </tr> <tr> <td style="text-align: left;">q_subtype</td> <td style="text-align: left;">int</td> <td>题目细分类</td> <td>是</td> <td>参见<a href="https://www.showdoc.com.cn/wjxopenapi/7569970778675459" title="3.4题目细分类型">3.4题目细分类型</a></td> </tr> <tr> <td style="text-align: left;">q_title</td> <td style="text-align: left;">string</td> <td>问题标题</td> <td>是</td> <td></td> </tr> <tr> <td style="text-align: left;">is_requir</td> <td style="text-align: left;">bool</td> <td>是否必填</td> <td>是</td> <td>默认为true</td> </tr> <tr> <td style="text-align: left;">has_jump</td> <td style="text-align: left;">bool</td> <td>是否有跳题逻辑</td> <td>是</td> <td>默认为false</td> </tr> <tr> <td style="text-align: left;">q_ceshi</td> <td style="text-align: left;">bool</td> <td>是否是考试</td> <td>否</td> <td>默认为false</td> </tr> <tr> <td style="text-align: left;">q_score</td> <td style="text-align: left;">doule</td> <td>问题分值</td> <td>否</td> <td>默认为0</td> </tr> <tr> <td style="text-align: left;">q_parsing</td> <td style="text-align: left;">string</td> <td>题目解析</td> <td>否</td> <td>默认为空</td> </tr> <tr> <td style="text-align: left;">prompt</td> <td style="text-align: left;">string</td> <td>填写提示</td> <td>否</td> <td>默认为空</td> </tr> </tbody> </table> <h2>2.1.1.5.2 单选题</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;">items</td> <td style="text-align: left;">item[]</td> <td>问题选项列表</td> <td>否</td> <td>参见<a href="#2.1.1.6.2">2.1.1.6.2item选项</a> get_items为false时,值为空</td> </tr> <tr> <td style="text-align: left;">has_value</td> <td style="text-align: left;">bool</td> <td>是否有值</td> <td>否</td> <td>默认为false</td> </tr> <tr> <td style="text-align: left;">choice_random</td> <td style="text-align: left;">bool</td> <td>是否选项随机</td> <td>否</td> <td>默认为false</td> </tr> <tr> <td style="text-align: left;">description</td> <td style="text-align: left;">string</td> <td>针对所有选项的说明文字</td> <td>否</td> <td>默认为空</td> </tr> <tr> <td style="text-align: left;">style</td> <td style="text-align: left;">int</td> <td>单选题展现形式</td> <td>否</td> <td>默认为常规<br>常规 = 0,<br>分值 = 1,<br>星级 = 2,<br>点赞 = 3,<br>条形 = 6,<br>描述 = 101,</td> </tr> <tr> <td style="text-align: left;">is_panduan</td> <td style="text-align: left;">bool</td> <td>是否为判断题</td> <td>否</td> <td>默认为false</td> </tr> <tr> <td style="text-align: left;">is_qingjing</td> <td style="text-align: left;">bool</td> <td>是否是情景题</td> <td>否</td> <td>默认为false</td> </tr> <tr> <td style="text-align: left;">is_nps</td> <td style="text-align: left;">bool</td> <td>是否是NPS量表题</td> <td>否</td> <td>默认为false</td> </tr> <tr> <td style="text-align: left;">vector_level</td> <td style="text-align: left;">int</td> <td>量表等级</td> <td>否</td> <td>默认为0, 即此题并非量表题</td> </tr> </tbody> </table> <h2>2.1.1.5.3 多选题</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;">items</td> <td style="text-align: left;">item[]</td> <td>问题选项列表</td> <td>否</td> <td>参见<a href="#2.1.1.6.2">2.1.1.6.2item选项</a> get_items为false时,值为空</td> </tr> <tr> <td style="text-align: left;">has_value</td> <td style="text-align: left;">bool</td> <td>是否有值</td> <td>否</td> <td>默认为false</td> </tr> <tr> <td style="text-align: left;">choice_random</td> <td style="text-align: left;">bool</td> <td>是否选项随机</td> <td>否</td> <td>默认为false</td> </tr> <tr> <td style="text-align: left;">description</td> <td style="text-align: left;">string</td> <td>针对所有选项的说明文字</td> <td>否</td> <td>默认为空</td> </tr> <tr> <td style="text-align: left;">check_mode</td> <td style="text-align: left;">int</td> <td>多选题模式</td> <td>否</td> <td>Mode=1表示排序题</td> </tr> <tr> <td style="text-align: left;">is_partscore</td> <td style="text-align: left;">bool</td> <td>少选得部分分值</td> <td>否</td> <td>默认为false</td> </tr> <tr> <td style="text-align: left;">fixed_partscore</td> <td style="text-align: left;">doule</td> <td>少选得固定分值</td> <td>否</td> <td>默认为0</td> </tr> <tr> <td style="text-align: left;">min_options</td> <td style="text-align: left;">int</td> <td>至少选项数</td> <td>否</td> <td>默认为0,不生效【get_setting为false时不返回】</td> </tr> <tr> <td style="text-align: left;">max_options</td> <td style="text-align: left;">int</td> <td>至多选项数</td> <td>否</td> <td>默认为0,不生效【get_setting为false时不返回】</td> </tr> <tr> <td style="text-align: left;">is_shop</td> <td style="text-align: left;">bool</td> <td>是否是商品题型</td> <td>否</td> <td>默认为false【get_setting为false时不返回】</td> </tr> <tr> <td style="text-align: left;">has_payment_channel</td> <td style="text-align: left;">bool</td> <td>是否设置了支付方式</td> <td>否</td> <td>默认为false【get_setting为false时不返回】</td> </tr> <tr> <td style="text-align: left;">min_shoptype</td> <td style="text-align: left;">int</td> <td>最少购买商品种数</td> <td>否</td> <td>默认为0,不生效【get_setting为false时不返回】</td> </tr> <tr> <td style="text-align: left;">max_shoptype</td> <td style="text-align: left;">int</td> <td>最多购买商品种数</td> <td>否</td> <td>默认为0,不生效【get_setting为false时不返回】</td> </tr> </tbody> </table> <h2>2.1.1.5.4 填空题</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;">verify</td> <td style="text-align: left;">int</td> <td>效验类型</td> <td>否</td> <td><strong>·</strong> 默认为0,即不验证<br><strong>·</strong> 参见<a href="https://www.showdoc.com.cn/wjxopenapi/7570033426367978" title="3.5文本校验类型">3.5文本校验类型</a></td> </tr> <tr> <td style="text-align: left;">need_only</td> <td style="text-align: left;">bool</td> <td>是否要求填写唯一</td> <td>否</td> <td>默认为false</td> </tr> <tr> <td style="text-align: left;">default_value</td> <td style="text-align: left;">string</td> <td>默认值</td> <td>否</td> <td>默认为空</td> </tr> <tr> <td style="text-align: left;">answer</td> <td style="text-align: left;">string</td> <td>填空答案</td> <td>否</td> <td>默认为空</td> </tr> <tr> <td style="text-align: left;">include_keyword</td> <td style="text-align: left;">bool</td> <td>是否包含答案即可</td> <td>否</td> <td>默认为false</td> </tr> <tr> <td style="text-align: left;">case_sensitive</td> <td style="text-align: left;">bool</td> <td>答案是否区分大小写</td> <td>否</td> <td>默认为false</td> </tr> <tr> <td style="text-align: left;">punctuation_sensitive</td> <td style="text-align: left;">bool</td> <td>答案是否区分标点符号</td> <td>否</td> <td>默认为false</td> </tr> <tr> <td style="text-align: left;">level_data</td> <td style="text-align: left;">string</td> <td>多级下拉菜单内容</td> <td>否</td> <td><strong>·</strong> verify=24是包含此参数<br><strong>·</strong> 默认为空</td> </tr> <tr> <td style="text-align: left;">allow_search</td> <td style="text-align: left;">bool</td> <td>多级下拉是否允许搜索</td> <td>否</td> <td><strong>·</strong> verify=24是包含此参数<br><strong>·</strong> 默认为false <br>【get_setting为false时不返回】</td> </tr> <tr> <td style="text-align: left;">height</td> <td style="text-align: left;">int</td> <td>高度(行数)</td> <td>否</td> <td>默认为0,不生效【get_setting为false时不返回】</td> </tr> <tr> <td style="text-align: left;">width</td> <td style="text-align: left;">int</td> <td>宽度</td> <td>否</td> <td>默认为0,不生效【get_setting为false时不返回】</td> </tr> <tr> <td style="text-align: left;">min_words</td> <td style="text-align: left;">int</td> <td>最小字数</td> <td>否</td> <td>默认为0,不生效【get_setting为false时不返回】</td> </tr> <tr> <td style="text-align: left;">max_words</td> <td style="text-align: left;">int</td> <td>最大字数</td> <td>否</td> <td>默认为0,不生效【get_setting为false时不返回】</td> </tr> <tr> <td style="text-align: left;">need_sms_verify</td> <td style="text-align: left;">bool</td> <td>使用短信验证</td> <td>否</td> <td><strong>·</strong> verify=4是包含此参数<br><strong>·</strong> 默认为false<br>get_setting为false时不返回】</td> </tr> <tr> <td style="text-align: left;">date_limit</td> <td style="text-align: left;">bool</td> <td>是否控制日期范围</td> <td>否</td> <td><strong>·</strong> verify=3是包含此参数<br><strong>·</strong> 默认为false<br>【get_setting为false时不返回】</td> </tr> <tr> <td style="text-align: left;">start_date_limit</td> <td style="text-align: left;">int</td> <td>日期开始时间</td> <td>否</td> <td><strong>·</strong> verify=3是包含此参数<br><strong>·</strong> 默认不带入参数,即不生效<br><strong>·</strong> 参数值含义如下:<br>0:当天<br>1:当前日期1天后<br>2:当前日期2天后<br>3:当前日期3天后<br>4:当前日期4天后<br>5:当前日期5天后<br>6:当前日期6天后<br>7:当前日期7天后<br>【get_setting为false时不返回】</td> </tr> <tr> <td style="text-align: left;">end_date_limit</td> <td style="text-align: left;">int</td> <td>日期结束时间</td> <td>否</td> <td><strong>·</strong> verify=3是包含此参数<br><strong>·</strong> 默认不带入参数,即不生效<br><strong>·</strong> 参数值含义如下:<br>-1:不限制<br>0:当前日期1天后<br>1:当前日期2天后<br>2:当前日期3天后<br>3:当前日期4天后<br>4:当前日期5天后<br>5:当前日期6天后<br>6:当前日期7天后<br>【get_setting为false时不返回】</td> </tr> </tbody> </table> <h2>2.1.1.5.5 多项填空题</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;">item_rows</td> <td style="text-align: left;">itemrow[]</td> <td>问题选项列表</td> <td>是</td> <td>参见<a href="#2.1.1.6.1">2.1.1.6.1itemrow选项</a></td> </tr> <tr> <td style="text-align: left;">gap_count</td> <td style="text-align: left;">int</td> <td>填空数量</td> <td>是</td> <td></td> </tr> <tr> <td style="text-align: left;">is_cloze</td> <td style="text-align: left;">bool</td> <td>是否是完型填空</td> <td>否</td> <td>默认为false</td> </tr> <tr> <td style="text-align: left;">case_sensitive</td> <td style="text-align: left;">bool</td> <td>答案是否区分大小写</td> <td>否</td> <td>默认为false</td> </tr> <tr> <td style="text-align: left;">punctuation_sensitive</td> <td style="text-align: left;">bool</td> <td>答案是否区分标点符号</td> <td>否</td> <td>默认为false</td> </tr> <tr> <td style="text-align: left;">use_textbox</td> <td style="text-align: left;">bool</td> <td>是否使用文本框样式</td> <td>否</td> <td>默认为false</td> </tr> </tbody> </table> <h2>2.1.1.5.6 矩阵题</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;">item_rows</td> <td style="text-align: left;">itemrow[]</td> <td>问题行标题</td> <td>是</td> <td>参见<a href="#2.1.1.6.1">2.1.1.6.1itemrow选项</a></td> </tr> <tr> <td style="text-align: left;">item_columns</td> <td style="text-align: left;">itemrowtitle[]</td> <td>问题列标题</td> <td>否</td> <td>参见 <a href="https://www.showdoc.com.cn/wjxopenapi/7580813132852078" title="2.1.4.5.3 itemrowtitle选项">2.1.4.5.3 itemrowtitle选项</a></td> </tr> <tr> <td style="text-align: left;">items</td> <td style="text-align: left;">item[]</td> <td>问题选项列表</td> <td>否</td> <td>参见<a href="#2.1.1.6.2">2.1.1.6.2item选项</td> </tr> <tr> <td style="text-align: left;">item_right_rows</td> <td style="text-align: left;">itemrow[]</td> <td>问题右行标题</td> <td>否</td> <td>参见<a href="#2.1.1.6.1">2.1.1.6.1itemrow选项</a></td> </tr> <tr> <td style="text-align: left;">matrix_mode</td> <td style="text-align: left;">int</td> <td>矩阵模式</td> <td>是</td> <td>参见3.6 矩阵展现形式</td> </tr> <tr> <td style="text-align: left;">table_mode</td> <td style="text-align: left;">int</td> <td>表格模式</td> <td>是</td> <td>参见3.7 表格展现形式</td> </tr> <tr> <td style="text-align: left;">has_value</td> <td style="text-align: left;">bool</td> <td>是否有值</td> <td>否</td> <td>默认为false【get_setting为false时不返回】</td> </tr> <tr> <td style="text-align: left;">is_random_row</td> <td style="text-align: left;">bool</td> <td>是否行标题随机</td> <td>否</td> <td>默认为false【get_setting为false时不返回】</td> </tr> <tr> <td style="text-align: left;">use_row_daozhi</td> <td style="text-align: left;">bool</td> <td>是否启用行列倒置</td> <td>否</td> <td>默认为false【get_setting为false时不返回】</td> </tr> <tr> <td style="text-align: left;">has_part_requir</td> <td style="text-align: left;">bool</td> <td>选项列表是否存在部分必答的情况</td> <td>否</td> <td>默认为false【get_setting为false时不返回】</td> </tr> <tr> <td style="text-align: left;">allow_digit</td> <td style="text-align: left;">bool</td> <td>是否允许小数</td> <td>否</td> <td>默认为false【get_setting为false时不返回】</td> </tr> <tr> <td style="text-align: left;">min_rows</td> <td style="text-align: left;">int</td> <td>自增表格题默认显示行数</td> <td>否</td> <td>默认为0,不生效【get_setting为false时不返回】</td> </tr> <tr> <td style="text-align: left;">max_rows</td> <td style="text-align: left;">int</td> <td>自增表格题最大允许行数</td> <td>否</td> <td>默认为0,不生效【get_setting为false时不返回】</td> </tr> </tbody> </table> <h2>2.1.1.5.7 文件上传题</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;">width</td> <td style="text-align: left;">int</td> <td>显示宽度</td> <td>否</td> <td>默认为200</td> </tr> <tr> <td style="text-align: left;">ext</td> <td style="text-align: left;">string</td> <td>上传文件后缀</td> <td>否</td> <td>默认为空,不限制</td> </tr> <tr> <td style="text-align: left;">max_size</td> <td style="text-align: left;">int</td> <td>上传文件大小限制</td> <td>否</td> <td>默认为4096KB</td> </tr> <tr> <td style="text-align: left;">max_length</td> <td style="text-align: left;">int</td> <td>上传文件个数限制</td> <td>否</td> <td>默认为1</td> </tr> <tr> <td style="text-align: left;">is_drawing</td> <td style="text-align: left;">bool</td> <td>是否是绘图题</td> <td>否</td> <td>仅绘图题时包含此参数值</td> </tr> <tr> <td style="text-align: left;">high_size</td> <td style="text-align: left;">int</td> <td>绘图板高度</td> <td>否</td> <td>仅绘图题时包含此参数值</td> </tr> <tr> <td style="text-align: left;">drawing_bg</td> <td style="text-align: left;">string</td> <td>绘图板背景图片</td> <td>否</td> <td>仅绘图题时包含此参数值</td> </tr> </tbody> </table> <h2>2.1.1.5.8 比重题</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;">total</td> <td style="text-align: left;">int</td> <td>可分配的总比重值</td> <td>是</td> <td>默认为100</td> </tr> <tr> <td style="text-align: left;">row_width</td> <td style="text-align: left;">int</td> <td>行标题宽度</td> <td>是</td> <td>默认为15</td> </tr> </tbody> </table> <h2>2.1.1.5.9 滑动条</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;">min_value</td> <td style="text-align: left;">int</td> <td>最小值</td> <td>是</td> <td>默认为0</td> </tr> <tr> <td style="text-align: left;">max_value</td> <td style="text-align: left;">int</td> <td>最大值</td> <td>是</td> <td>默认为100</td> </tr> <tr> <td style="text-align: left;">min_value_text</td> <td style="text-align: left;">string</td> <td>最小值描述</td> <td>否</td> <td>默认为空</td> </tr> <tr> <td style="text-align: left;">max_value_text</td> <td style="text-align: left;">string</td> <td>最大值描述</td> <td>否</td> <td>默认为空</td> </tr> </tbody> </table> <ul> <li> <h1>2.1.1.6 题目选项对象参数(item)</h1> <div id = "2.1.1.6.1"></div> </li> </ul> <h2>2.1.1.6.1 itemrow选项(所有选项均包含此属性)</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> <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_title</td> <td style="text-align: left;">string</td> <td>选项标题</td> <td>是</td> <td></td> </tr> </tbody> </table> <div id = "2.1.1.6.2"></div> <h2>2.1.1.6.2 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;">item_score</td> <td style="text-align: left;">string</td> <td>选项分值</td> <td>是</td> <td><strong>·</strong> 当为商品题时,值为商品的价格<br><strong>·</strong> 当为情景题时,值为情景的数量限制</td> </tr> <tr> <td style="text-align: left;">item_max</td> <td style="text-align: left;">int</td> <td>矩阵题中,选项可选择的最大次数</td> <td>否</td> <td>矩阵题才有</td> </tr> <tr> <td style="text-align: left;">item_selected</td> <td style="text-align: left;">bool</td> <td>默认选中</td> <td>否</td> <td>为考虑时,默认选中的选项为正确答案</td> </tr> <tr> <td style="text-align: left;">allow_filltext</td> <td style="text-align: left;">bool</td> <td>允许填空</td> <td>否</td> <td>选择题才有</td> </tr> <tr> <td style="text-align: left;">is_item_required</td> <td style="text-align: left;">bool</td> <td>允许填空时,是否必填</td> <td>否</td> <td>选择题才有</td> </tr> <tr> <td style="text-align: left;">item_image</td> <td style="text-align: left;">string</td> <td>选项图片引用</td> <td>否</td> <td>选择题才有</td> </tr> <tr> <td style="text-align: left;">item_image_text</td> <td style="text-align: left;">string</td> <td>选项文字描述,可以是文字描述或Url引用</td> <td>否</td> <td>选择题才有</td> </tr> <tr> <td style="text-align: left;">is_item_huchi</td> <td style="text-align: left;">bool</td> <td>选项是否互斥,仅对多选题有用</td> <td>否</td> <td>多选题才有</td> </tr> <tr> <td style="text-align: left;">shop_unit</td> <td style="text-align: left;">string</td> <td>购买商品单位</td> <td>否</td> <td>商品题才有</td> </tr> <tr> <td style="text-align: left;">min_shopnum</td> <td style="text-align: left;">int</td> <td>购买商品最小数量</td> <td>否</td> <td>商品题才有</td> </tr> <tr> <td style="text-align: left;">max_shopnum</td> <td style="text-align: left;">int</td> <td>购买商品最大数量</td> <td>否</td> <td>商品题才有</td> </tr> <tr> <td style="text-align: left;">item_jump</td> <td style="text-align: left;">int</td> <td>跳转至对应编号的题目</td> <td>否</td> <td><strong>·</strong> 选择题或商品题才有<br><strong>·</strong> 商品题时代表总库存<br><strong>·</strong> 0:代表不跳转按顺序填写下一题<br><strong>·</strong> 1:代表跳转到问卷末尾结束作答<br><strong>·</strong> -1:代表直接提交为无效答卷</td> </tr> </tbody> </table> <h2>2.1.1.6.3 itemrowtitle选项</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;">verify</td> <td style="text-align: left;">int</td> <td>文本效验类型</td> <td>否</td> <td>参见<a href="https://www.showdoc.com.cn/wjxopenapi/7570033426367978" title="3.5文本校验类型">3.5文本校验类型</a></td> </tr> <tr> <td style="text-align: left;">is_requir</td> <td style="text-align: left;">bool</td> <td>是否是必答项</td> <td>否</td> </tr> <tr> <td style="text-align: left;">need_only</td> <td style="text-align: left;">bool</td> <td>是否检查唯一性</td> <td>否</td> </tr> <tr> <td style="text-align: left;">item_choice</td> <td style="text-align: left;">string</td> <td>下拉选项,用逗号分隔</td> <td>否</td> </tr> <tr> <td style="text-align: left;">min_words</td> <td style="text-align: left;">int</td> <td>最小字数</td> <td>否</td> </tr> <tr> <td style="text-align: left;">max_words</td> <td style="text-align: left;">int</td> <td>最大字数</td> <td>否</td> </tr> <tr> <td style="text-align: left;">ext</td> <td style="text-align: left;">string</td> <td>上传文件后缀</td> <td>否</td> <td>默认为空,不限制</td> </tr> <tr> <td style="text-align: left;">max_size</td> <td style="text-align: left;">int</td> <td>上传文件大小限制</td> <td>否</td> <td>默认为4096KB</td> </tr> </tbody> </table> <div id = "2.1.2.7"></div> <ul> <li> <h1>2.1.2.7 题目扩展对象(qextraction)</h1> </li> </ul> <h2>2.1.2.7.0 公共参数</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_answerid</td> <td style="text-align: left;">int</td> <td>答案编号</td> <td>是</td> </tr> <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_type</td> <td style="text-align: left;">int</td> <td>题目类型</td> <td>是</td> <td>参见<a href="https://www.showdoc.com.cn/wjxopenapi/7569895747572645" title="3.3 题目类型">3.3 题目类型</a></td> </tr> <tr> <td style="text-align: left;">q_subtype</td> <td style="text-align: left;">int</td> <td>题目细分类</td> <td>是</td> <td>参见<a href="https://www.showdoc.com.cn/wjxopenapi/7569970778675459" title="3.4 题目细分类型">3.4题目细分类型</a></td> </tr> </tbody> </table> <p>不同题型差异部分:</p> <h2>2.1.2.7.1 单选题</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;">item_index</td> <td style="text-align: left;">int</td> <td>答案对应选项编号</td> <td>是</td> </tr> <tr> <td style="text-align: left;">items</td> <td style="text-align: left;">item[]</td> <td>问题选项列表</td> <td>是</td> <td>参见<a href="#2.1.1.6.2">2.1.1.6.2item选项</a></td> </tr> </tbody> </table> <h2>2.1.2.7.2多选题</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;">item_index</td> <td style="text-align: left;">int</td> <td>答案对应选项编号</td> <td>是</td> </tr> <tr> <td style="text-align: left;">item</td> <td style="text-align: left;">item</td> <td>问题选项</td> <td>是</td> <td>参见<a href="#2.1.1.6.2">2.1.1.6.2item选项</a></td> </tr> </tbody> </table> <h2>2.1.2.7.3 填空题</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;"></td> <td style="text-align: left;"></td> <td></td> <td></td> </tr> </tbody> </table> <h2>2.1.2.7.4多项填空题</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;">item</td> <td style="text-align: left;">item</td> <td>问题选项</td> <td>是</td> <td>参见2.1.1.6.2item选项</td> </tr> </tbody> </table> <h2>2.1.2.7.5矩阵题</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;">item_row_index</td> <td style="text-align: left;">int</td> <td>矩阵行编号</td> <td>是</td> </tr> <tr> <td style="text-align: left;">item_col_index</td> <td style="text-align: left;">int</td> <td>矩阵列编号</td> <td>是</td> </tr> <tr> <td style="text-align: left;">items</td> <td style="text-align: left;">item[]</td> <td>问题选项列表</td> <td>是</td> <td>参见<a href="#2.1.1.6.2">2.1.1.6.2item选项</a></td> </tr> <tr> <td style="text-align: left;">item_right_rows</td> <td style="text-align: left;">itemrow</td> <td>问题右行标题</td> <td>是</td> <td>参见<a href="#2.1.1.6.1">2.1.1.6.1itemrow选项</a></td> </tr> <tr> <td style="text-align: left;">item_rows</td> <td style="text-align: left;">itemrow</td> <td>问题行标题</td> <td>是</td> <td>参见<a href="#2.1.1.6.1">2.1.1.6.1itemrow选项</a></td> </tr> <tr> <td style="text-align: left;">item_columns</td> <td style="text-align: left;">itemrowtitle</td> <td>问题列标题</td> <td>是</td> <td>参见<a href="https://www.showdoc.com.cn/wjxopenapi/7580813132852078" title="2.1.4.5.3 itemrowtitle选项">2.1.4.5.3 itemrowtitle选项</a></td> </tr> </tbody> </table> <h2>2.1.2.7.6文件上传题</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;"></td> <td style="text-align: left;"></td> <td></td> <td></td> </tr> </tbody> </table> <h2>2.1.2.7.7比重题</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;"></td> <td style="text-align: left;"></td> <td></td> <td></td> </tr> </tbody> </table> <h2>2.1.2.7.8滑动条</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;"></td> <td style="text-align: left;"></td> <td></td> <td></td> </tr> </tbody> </table> <div id = "2.1.2.8"></div> <ul> <li> <h1>2.1.2.8 简洁模式对象</h1> </li> </ul> <h2>2.1.2.8.1 Questionaire对象</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;">Id</td> <td style="text-align: left;">string</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;">TypeName</td> <td style="text-align: left;">string</td> <td>题目类型</td> <td>是</td> </tr> <tr> <td style="text-align: left;">Info</td> <td style="text-align: left;">object</td> <td>多项填空、比重。矩阵题项目</td> <td>否</td> <td>举例:{&quot;q1_1&quot;: &quot;问答1&quot;, &quot;q1_2&quot;: &quot;问答2&quot; }</td> </tr> <tr> <td style="text-align: left;">Values</td> <td style="text-align: left;">List<Choice></td> <td>选择题选项</td> <td>否</td> <td><a href="#2.1.2.8.2">Choice类型参考2.1.2.8.2</a></td> </tr> </tbody> </table> <div id = "2.1.2.8.2"></div> <h2>2.1.2.8.2简洁模式选项Choice类型</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;">Id</td> <td style="text-align: left;">int</td> <td>选择项序号</td> <td>是</td> </tr> <tr> <td style="text-align: left;">Text</td> <td style="text-align: left;">string</td> <td>选择项文本内容</td> <td>是</td> </tr> <tr> <td style="text-align: left;">Image</td> <td style="text-align: left;">string</td> <td>选择项图片</td> <td>否</td> </tr> <tr> <td style="text-align: left;">ImageDesc</td> <td style="text-align: left;">string</td> <td>选择项图片描述</td> <td>否</td> </tr> </tbody> </table> <div id = "fhsl.1"></div> <ul> <li>返回示例(完整模式)</li> </ul> <pre><code class="language-csharp">{ "result": true, "data": { "vid": 91432, "begin_time": "2019-12-27 10:31:43", "update_time": "2019-12-27 10:31:43", "atype": 1, "title": "", "description": "", "version": 1, "answer_valid": 22, "answer_total": 22, "status": 1, "verify_status": 2, "questions": [ { "items": [ { "item_image": "", "q_index": 1, "item_index": 1, "item_title": "选项2", "item_score": 1.0, "item_selected": false }, { "item_image": "", "q_index": 1, "item_index": 2, "item_title": "选项3", "item_score": 2.0, "item_selected": false } ], "q_index": 1, "q_type": 3, "q_subtype": 3, "q_title": "标题", "is_requir": true, "has_jump": false }, { "items": [ { "item_image": "", "q_index": 2, "item_index": 1, "item_title": "选项4", "item_score": 1.0, "item_selected": false }, { "item_image": "", "q_index": 2, "item_index": 2, "item_title": "选项5", "item_score": 2.0, "item_selected": false } ], "q_index": 2, "q_type": 3, "q_subtype": 3, "q_title": "标题", "is_requir": true, "has_jump": false }, { "items": [ { "item_image": "", "q_index": 3, "item_index": 1, "item_title": "选项6", "item_score": 1.0, "item_selected": false }, { "item_image": "", "q_index": 3, "item_index": 2, "item_title": "选项7", "item_score": 2.0, "item_selected": false } ], "q_index": 3, "q_type": 3, "q_subtype": 3, "q_title": "标题", "is_requir": true, "has_jump": false } ], "total_score": 0.0 } }</code></pre> <div id = "fhsl.2"></div> <ul> <li>返回示例2(简洁模式) <pre><code class="language-csharp">Content-Type:application/json { "result": true, "data": "title:hes考试&lt;br/&gt;q1:标题&lt;br/&gt;q1#1:选项1&lt;br/&gt;q1#2:选项2&lt;br/&gt;q2:标题二&lt;br/&gt;q3:标题三&lt;br/&gt;" }</code></pre> <div id = "fhsl.3"></div></li> <li>返回示例3(简洁模式) <pre><code class="language-csharp">Content-Type:application/json { "result": true, "data": { "Title": "hes考试", "Questions": [ { "Id": "q1", "Title": "标题", "TypeName": "考试单选", "Info": null, "Values": [ { "Id": 1, "Text": "选项1", "Image": "", "ImageDesc": "" }, { "Id": 2, "Text": "选项2", "Image": "", "ImageDesc": "" } ] }, { "Id": "q2", "Title": "标题二", "TypeName": "考试简答", "Info": null, "Values": [] }, { "Id": "q3", "Title": "标题三", "TypeName": "单项填空", "Info": null, "Values": [] } ] } }</code></pre></li> </ul>

页面列表

ITEM_HTML