商品搜索提示
商品搜索提示作为关键词智能提示，主要作用是避免用户输入错误的搜索词，并将用户引导到相应的关键词上，以提升用户搜索体验。比如用户输入"苹"能够自动提示"苹果"、"苹果手机"。 商品搜索提示支持如下特性：
- 支持前缀匹配原则
在搜索框中输入"海底"，搜索框下面会以海底为前缀，展示"海底捞"、"海底捞火锅"、"海底世界"等等搜索词；输入"万达"，会提示"万达影城"、"万达广场"、"万达百货"等搜索词。 - 同时支持汉字、拼音输入
由于中文的特点，如果搜索自动提示可以支持拼音的话会给用户带来更大的方便，免得切换输入法。比如，输入"haidi"提示的关键字和输入"海底"提示的一样，输入"wanda"与输入"万达"提示的关键字一样。 - 支持多音字输入提示
比如输入"chongqing"或者"zhongqing"都能提示出"重庆火锅"、"重庆烤鱼"、"重庆小天鹅"。 - 支持拼音缩写输入
对于较长关键字，为了提高输入效率，有必要提供拼音缩写输入。比如输入"hd"应该能提示出"haidi"相似的关键字，输入"wd"也一样能提示出"万达"关键字。
详细描述见算法篇搜索提示章节
1. 搜索提示
根据关键词提示候选搜索关键词。
| URL | HTTP | 功能 |
|---|---|---|
| /suggests/:adminId | GET | 返回候选搜索关键词 |
请求参数
| 参数名 | 数据类型 | 可需 | 描述 |
|---|---|---|---|
| q | string | 必填 | suggest输入单词 |
| size | int | 选填 | 关键词数目，默认为10，最大为50 |
| format | string | 选填 | 返回数据的格式，支持json、xml、yaml，默认json；也可以在HTTP header accept参数中指定返回消息格式 |
返回结果
- 返回结果中"key"字段表示候选提示词，"doc_count"字段表示符合该提示词的商品数目。
HTTP 200 OK
Content-Type: application/json
Vary: Accept
Allow: GET
[
{
"key": "爱普生",
"doc_count": 28
},
{
"key": "爱普生(EPSON)",
"doc_count": 9
},
{
"key": "ap",
"doc_count": 6
},
{
"key": "apple",
"doc_count": 5
},
{
"key": "apos",
"doc_count": 3
},
{
"key": "aps",
"doc_count": 1
},
{
"key": "安普",
"doc_count": 2
},
{
"key": "安普超",
"doc_count": 2
}
]