|
|
## 搜索通用参数
|
|
|
|
|
|
参数名称 | 参数解释 | 参数值范围 | 备注 | 传参示例
|
|
|
---|--------:|---:|---|---
|
|
|
brand|品牌id|all_brand_ids|支持传个值,逗号隔开|[brand=1][brand=1,2,3,4]
|
|
|
shop|店铺Id|all_shop_ids |支持传个值,逗号隔开 |[shop=1][shop=1,2,3,4]
|
|
|
msort| 商品大分类id| all_msort_ids |支持传个值,逗号隔开| [msort=1][msort=1,2,3,4]
|
|
|
misort| 商品中分类id |all_misort_ids |支持传个值,逗号隔开| [misort=1][misort=1,2,3,4]
|
|
|
sort |商品小分类id|all_sort_ids |支持传个值,逗号隔开| [sort=1][sort=1,2,3,4]
|
|
|
color |商品颜色id |all_color_ids |支持传个值,逗号隔开| [color=1][color=1,2,3,4]
|
|
|
size |商品尺码id |all_size_ids |支持传个值,逗号隔开| [size=1][size=1,2,3,4]
|
|
|
price |商品售价 |1~Integer.max |>=最小值,<=最大值,逗号隔开| [price=100,200]
|
|
|
gender |男/女/通用款 |1(男),2(女),3(通用) |支持传个值,逗号隔开| [gender=1,3][gender=2,3]
|
|
|
specialoffer| 是否为促销品[5折以下] |Y/N| 不支持传多个值| [specialoffer=Y]
|
|
|
isdiscount| 是否打折| Y/N |不支持传多个值 |[isdiscount=Y]
|
|
|
parameter_{id} |待研究 |||
|
|
|
sales| 是否在售| Y/N| 不支持传多个值 |[sales=Y]
|
|
|
promotion| 是否促销/推广| 所有的is_promotion |传表product.is_promotion| [promotion=0]
|
|
|
vdt| vip折扣类型| 所有vip折扣类型| 传表product.vip_discount_type |[vdt=1][vdt=3]
|
|
|
p_d| 折扣范围-浮点型| 0~1| >=最小值,<=最大值,逗号隔开 |[p_d=0.1,0.3]
|
|
|
p_d_int| 折扣范围-整型 0~10| >=最小值,<=最大值,逗号隔开|【其中0.383在这里也是三折】| [p_d_int=1,3]
|
|
|
attribute| 商品属性 |1[正常商品]/2[赠品]| 不支持传多个值| [attribute=1]
|
|
|
stocknumber |最小库存 |0~Integer.max |不支持传多个值 |[stocknumber=1]:表明库存>=1
|
|
|
limited |是否限量| Y/N |不支持传多个值| [limited=1]
|
|
|
new |是否新品| Y/N |不支持传多个值| [new=1]
|
|
|
outlets |是否奥莱 |1/2 |不支持传多个值 |[outlets=1]
|
|
|
status |商品是否上架|0/1| 不支持传多个值| [status=1]
|
|
|
style |商品风格 |所有风格id |支持传个值,逗号隔开| [style=966,965]
|
|
|
sell_channels| 销售平台| 表product.all.sell_channels| 传表product.sell_channels| [sell_channels=0,1,2,3]
|
|
|
folder_id |商品目录id| 表product.all.folder_id |传表product.folder_id |[folder_id=237]
|
|
|
series_id |商品系列id |表product.all.series_id |传表product.series_id| [folder_id=1797]
|
|
|
first_shelve_time| 首次上架时间间隔| 时间戳间隔| >=最小值,<=最大值,逗号隔开 |[first_shelve_time=1426243037,1426593516]
|
|
|
shelve_time| 最近上架日期间隔 |时间戳间隔 |>=最小值,<=最大值,逗号隔开 |[shelve_time=1426243037,1426593516]
|
|
|
day |最近上架日期| 最近上架日期【shelve_day】 |不支持传多个值| [shelve_day=2015-03-13]
|
|
|
act_temp| 活动属性-模板id| 活动属性里的模板id| 不支持传多个值activity_product.template_id|
|
|
|
act_rec| 活动属性-是否推荐| 活动属性里的是否推荐| 传表activity_product.template_id |
|
|
|
act_status| 活动属性-状态| 活动属性里的状态| 传表activity_product.status
|
|
|
breaking| 是否断码 |1或不传,详见【断码逻辑】| 不支持传多个值 |[breaking=1]
|
|
|
product_skn| 商品skns |搜索商品的skn| 支持多传,逗号隔开| [product_skn=50029945,51089136]
|
|
|
ageLevel| 年龄层| 年龄层(1成人 2大童 3小童 ) |支持多传,逗号隔开| [ageLevel=1,2]
|
|
|
not_{key}| 某个字段值为XX| 通用过滤属性 |不支持传多个值 |[not_brand=1]:品牌id不为1
|
|
|
filter_{key}| 某个字段值为XX| 通用过滤属性 |不支持传多个值| [filter_brand=1]:品牌id为1
|
|
|
missing_{key}| 某个字段值为空| 通用过滤属性 |不支持传多个值| [filter_brand]:品牌id不存在
|
|
|
|
|
|
## api
|
|
|
**1、获取年龄段的聚合结果**【原search.json逻辑中有提前聚合的概念】
|
|
|
接口:http://192.168.102.216:8080/yohosearch/productindex/aggAgeLevel.json
|
|
|
参数:同搜索通用参数
|
|
|
备注:如果传了ageLevel,则只会聚合出该结果。【原search.json逻辑中有提前聚合:即去除ageLevel参数去聚合】
|
|
|
返回示例:
|
|
|
![返回示例](http://img11.static.yhbimg.com/yhb-img01/2016/08/31/10/01f0dcdb75bc4c46238a029c5199fef493.png)
|
|
|
**2、获取性别层面的聚合结果**【原search.json逻辑中有提前聚合的概念】
|
|
|
接口:http://192.168.102.216:8080/yohosearch/productindex/aggGender.json
|
|
|
参数:同搜索通用参数
|
|
|
备注:如果传了gender,则只会聚合出该结果。【原search.json逻辑中有提前聚合:即去除gender参数去聚合】
|
|
|
返回示例:
|
|
|
![返回示例](http://img10.static.yhbimg.com/yhb-img01/2016/08/31/10/0173e3e1240d33d3bb8c5072d3bf66e05a.png)
|
|
|
**3、获取价格层面的聚合结果**【原search.json逻辑中有提前聚合的概念】
|
|
|
接口:http://192.168.102.216:8080/yohosearch/productindex/aggPrice.json?price=0,569
|
|
|
参数:同搜索通用参数
|
|
|
备注:如果传了price范围,则只会聚合出该范围内的价格结果。【原search.json逻辑中有提前聚合:去除price参数去聚合】
|
|
|
返回示例:
|
|
|
![返回示例](http://img10.static.yhbimg.com/yhb-img01/2016/08/31/10/01d611fe22d947c36c354730cc483f1ac0.png)
|
|
|
**4、获取颜色层面的聚合结果**
|
|
|
接口:http://192.168.102.216:8080/yohosearch/productindex/aggColor.json?price=0,1&status=1&color=15,16
|
|
|
参数:同搜索通用参数
|
|
|
备注:如果传了color,则先过滤出该颜色的所有商品,再取这些商品的所有颜色。【原search.json逻辑中有提前聚合:去除color参数去聚合】
|
|
|
返回示例:
|
|
|
![返回示例](http://img11.static.yhbimg.com/yhb-img01/2016/08/31/10/0185e6c1c820d565bcbc2c5d846ed3f54d.png)
|
|
|
**5、获取风格层面的聚合结果**
|
|
|
接口:http://192.168.102.216:8080/yohosearch/productindex/aggStyle.json?style=1106&query=耐克鞋
|
|
|
参数:同搜索通用参数
|
|
|
备注:如果传了style,则先过滤出该风格下的所有商品,再取这些商品的所有风格。【原search.json逻辑中有提前聚合:去除style参数去聚合】
|
|
|
返回示例:
|
|
|
![返回示例](http://img11.static.yhbimg.com/yhb-img01/2016/08/31/10/01d9ebb46920ce50ca1bafd7fd43a9b699.png)
|
|
|
**6、获取品牌层面的聚合结果**
|
|
|
接口:http://192.168.102.216:8080/yohosearch/productindex/aggBrand.json?brand=144
|
|
|
参数:同搜索通用参数
|
|
|
备注:如果传了brand,则只会聚合出该品牌。【原search.json逻辑中有提前聚合:去除brand参数去聚合】
|
|
|
返回示例:
|
|
|
![返回示例](http://img10.static.yhbimg.com/yhb-img01/2016/08/31/10/01d00d5b7db87658287d4caa873cac0e0c.png)
|
|
|
**7、获取规则层面的聚合结果**
|
|
|
接口:http://192.168.102.216:8080/yohosearch/productindex/aggStandard.json?parameter_787=4439
|
|
|
参数:同搜索通用参数
|
|
|
备注:如果传了parameter_xxx,则先用parameter_xxx过滤,再聚合出商品的规则信息。
|
|
|
返回示例:
|
|
|
![返回示例](http://img11.static.yhbimg.com/yhb-img01/2016/08/31/10/0187fcdc8b06bbccc2ebcd30370dd8ba20.png)
|
|
|
**8、获取尺码层面的聚合结果**
|
|
|
接口:http://192.168.102.216:8080/yohosearch/productindex/aggSize.json?size=1
|
|
|
参数:同搜索通用参数
|
|
|
备注:如果传了size,则先用size过滤,再聚合出商品的尺码信息。【以前的search.json请求参数里没有size参数的时候才会去聚合尺码】
|
|
|
返回示例:
|
|
|
![返回示例](http://img10.static.yhbimg.com/yhb-img01/2016/08/31/10/0155bd5081377088d982cb4f0bbd0dc228.png)
|
|
|
**9、获取是否新品的聚合结果**
|
|
|
接口:http://192.168.102.216:8080/yohosearch/productindex/aggNew.json
|
|
|
参数:同搜索通用参数
|
|
|
备注:根据参数过滤出来的商品,只要有一个商品是new,则整个聚合结果为true
|
|
|
返回示例:
|
|
|
![返回示例](http://img11.static.yhbimg.com/yhb-img01/2016/08/31/10/01fac49d62074d875e9101624ca124bb00.png)
|
|
|
**10、获取是否限量的聚合结果**
|
|
|
接口:http://192.168.102.216:8080/yohosearch/productindex/aggLimited.json
|
|
|
参数:同搜索通用参数
|
|
|
备注:根据参数过滤出来的商品,只要有一个商品是limited,则整个聚合结果为true
|
|
|
返回示例:
|
|
|
![返回示例](http://img11.static.yhbimg.com/yhb-img01/2016/08/31/10/013ccd0a78920ec6d125fceb9c5ff2096a.png)
|
|
|
**11、获取是否特价的聚合结果**
|
|
|
接口:http://192.168.102.216:8080/yohosearch/productindex/aggSpecialoffer.json
|
|
|
参数:同搜索通用参数
|
|
|
备注:根据参数过滤出来的商品,只要有一个商品是isSpecialoffer,则整个聚合结果为true
|
|
|
返回示例:
|
|
|
![返回示例](http://img10.static.yhbimg.com/yhb-img01/2016/08/31/10/01f467daafe60dc5cb86eb9068b29e1632.png)
|
|
|
**12、获取商品列表**
|
|
|
接口:http://192.168.102.216:8080/yohosearch/productindex/productList.json
|
|
|
参数:同搜索通用参数
|
|
|
备注:拿参数去过滤,total表示商品总数【参数viewNum默认显示10条】
|
|
|
返回示例:
|
|
|
![返回示例](http://img10.static.yhbimg.com/yhb-img01/2016/08/31/10/01887d85cfe223f943be069fa51867eab6.png)
|
|
|
**13、获取商品数量**
|
|
|
接口:http://192.168.102.216:8080/yohosearch/productindex/productCount.json
|
|
|
参数:同搜索通用参数
|
|
|
备注:拿参数去过滤,total表示商品总数
|
|
|
返回示例:
|
|
|
![返回示例](http://img10.static.yhbimg.com/yhb-img01/2016/08/31/10/014cd9f165f645bc140daf3515913c3187.png) |
...
|
...
|
|