移动搜索接口
<p><strong>简要描述:</strong> </p>
<ul>
<li>移动搜索接口</li>
</ul>
<p><strong>请求URL:</strong> </p>
<ul>
<li><code>/api/v1/search/</code></li>
</ul>
<p><strong>请求方式:</strong></p>
<ul>
<li>POST </li>
</ul>
<p><strong>参数:</strong> </p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">query_name</td>
<td style="text-align: left;">本次查询的名字,可以与查询的字符串一致,也可以不一致,后端会直接把这个信息作为结果的一部分进行返回</td>
<td style="text-align: left;">string</td>
<td>否</td>
</tr>
<tr>
<td style="text-align: left;">text</td>
<td style="text-align: left;">放入搜索引擎的实际文本</td>
<td style="text-align: left;">string</td>
<td>否</td>
</tr>
<tr>
<td style="text-align: left;">pn</td>
<td style="text-align: left;">页数</td>
<td style="text-align: left;">int</td>
<td>否</td>
</tr>
<tr>
<td style="text-align: left;">rn</td>
<td style="text-align: left;">每页显示数量</td>
<td style="text-align: left;">int</td>
<td>否</td>
</tr>
<tr>
<td style="text-align: left;">map_keys</td>
<td style="text-align: left;">需要分页的主键列表</td>
<td style="text-align: left;">list</td>
<td>否</td>
</tr>
</tbody>
</table>
<h5>分页参数的说明</h5>
<p>对于列表情况,传入pn rn两个参数,分别表示页数和每一个页面内的个数
对于映射情况,传入映射的键列表,pn,rn三个参数,</p>
<p>例如,对于一个列表结构的数据,如果想取第二页,每页100个对象,则pagination_info填入下列数据
{"pagination_info":{"pn":100,"rn":2}}</p>
<p>对于一个字典,如果想提取 c123,c456,c789三个键的内容,则pagination_info填入下列数据
{"pagination_info":{"map_keys":["c123","c456","c789"], "pn":100,"rn":2}}
那么返回数据将包括映射中 "c123","c456","c789"三个键下面的第二页数据
如下所示:</p>
<pre><code>pn,rn,map_keys 必须封装到pagination_info中使用
pagination_info:{'rn':'','pn':'','map_keys':[]}</code></pre>
<h5>返回数据参数</h5>
<p>一个字典</p>
<table>
<thead>
<tr>
<th>字段名</th>
<th>含义</th>
<th>数据类型</th>
</tr>
</thead>
<tbody>
<tr>
<td>data</td>
<td>数据</td>
<td>字典</td>
</tr>
<tr>
<td>allow_pagination</td>
<td>是否可分页</td>
<td>布尔值</td>
</tr>
<tr>
<td>total_amount</td>
<td>原始数据的总条数</td>
<td>int</td>
</tr>
<tr>
<td>num_pages</td>
<td>总页数</td>
<td>int</td>
</tr>
<tr>
<td>page_index</td>
<td>当前页数</td>
<td>int</td>
</tr>
<tr>
<td>page_amount</td>
<td>每页显示数量</td>
<td>int</td>
</tr>
</tbody>
</table>
<p>front type目前有这么几种,list, map, number_map, time_map,其中map是一般的文本映射,time_map和number_map是时间轴,number_function是柱状图</p>
<p><strong>返回示例</strong>
fronttype=list</p>
<pre><code>{
"msg": "",
"code": 1,
"resultObj": {
"page_index": 1,
"num_pages": 0,
"total_amount": 0,
"allow_pagination": false,
"page_amount": 0,
"data": {
"index": {
"c71_lik3qyZM": {
"concept": "歌手", //概念名
"resource": null,
"number": null, //数字
"key": "c71_lik3qyZM", // 主键
"coordinate": null, // 坐标
"aka": "刘德华,andy lau,lau tak wah,华仔,华dee,华哥等",//别称
"structure": null,
"name": "刘德华" // 对象基本名
},
"c39_I0bEvljh": {
"concept": "演员",
"resource": "",
"name": "刘德华",
"number": null,
"key": "c39_I0bEvljh",
"coordinate": null,
"aka": "Andy Lau",
"structure": ""
}
},
"fronttype": "list",
"content": [
"c39_I0bEvljh",
"c71_lik3qyZM"
],
"allow_pagination": false,
"message": "关于刘德华的信息", //message是附属在查询结果中的说明文字
"query_name": "刘德华", //查询的名字,直接返回前端提交的查询的名字
"predicator": "列表<事物>",
"type": null,
"feaction": [ //这个部分包含一些列的相关搜索,其中suggestion 表示用于前端显示的查询描述,search_text则是实际提交到后台的查询字符串
{
"search_text": "刘德华#电影#集数",
"suggestion": "按集数组织这些电影"
},
{
"search_text": "刘德华#电影#导演",
"suggestion": "查看上述电影的导演"
},
{
"search_text": "刘德华#电影#国家",
"suggestion": "按国家组织这些电影"
},
]
}
}
}</code></pre>
<p>fronttype=map</p>
<pre><code>{
"msg": "",
"code": 1,
"resultObj": {
"page_index": 1,
"num_pages": 0,
"total_amount": 0,
"allow_pagination": false,
"page_amount": 10,
"data": {
"index": {
"c39_P730YMoJ": {
"info": "",
"concept": "演员",
"resource": "",
"number": null,
"_audio": [],
"_img": [],
"key": "c39_P730YMoJ",
"coordinate": null,
"aka": "Si Yang",
"_video": [],
"structure": "",
"name": "杨斯"
},
}
"fronttype": "map",
"content": {
"c90_cIYKxAm4": [
"c39_07Ql1SRa",
"c39_0cMgXI6c",
"c39_0cQfGlIL",
]
}
"allow_pagination": false,
"message": null,
"predicator": "映射<电影,演员>",
"type": "object",
"feaction": null
}
}</code></pre>
<p>fronttype=map text=刘德华电影评分</p>
<pre><code>{
"msg": "",
"code": 1,
"resultObj": {
"page_index": 1,
"num_pages": 0,
"total_amount": 0,
"allow_pagination": false,
"page_amount": 10,
"data": {
"index": {
"c22_epYaacKG": {
"info": "",
"concept": "评分",
"resource": null,
"name": null,
"number": 6.5,
"_audio": [],
"_img": [],
"key": "c22_epYaacKG",
"coordinate": null,
"aka": null,
"_video": [],
"structure": null
},
}
"content": {
"c22_eiZmZHKG": [
"c90_B8TyhHKu",
"c90_CY5mSHKu",
"c90_wmCFxHKu",
"c90_mz8PbcKu"
],
}
"fronttype": "number_map",
"allow_pagination": false,
"message": null,
"predicator": "映射<评分,电影>",
"type": "object",
"feaction": null
}
}
}</code></pre>