ttj1314 / API-Interfaces · Files

搜索通用参数

参数名称	参数解释	参数值范围	备注	传参示例
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参数去聚合】
返回示例：

2、获取性别层面的聚合结果【原search.json逻辑中有提前聚合的概念】
接口：http://192.168.102.216:8080/yohosearch/productindex/aggGender.json
参数：同搜索通用参数
备注：如果传了gender，则只会聚合出该结果。【原search.json逻辑中有提前聚合：即去除gender参数去聚合】
返回示例：

3、获取价格层面的聚合结果【原search.json逻辑中有提前聚合的概念】
接口：http://192.168.102.216:8080/yohosearch/productindex/aggPrice.json?price=0,569
参数：同搜索通用参数
备注：如果传了price范围，则只会聚合出该范围内的价格结果。【原search.json逻辑中有提前聚合：去除price参数去聚合】
返回示例：

4、获取颜色层面的聚合结果
接口：http://192.168.102.216:8080/yohosearch/productindex/aggColor.json?price=0,1&status=1&color=15,16
参数：同搜索通用参数
备注：如果传了color，则先过滤出该颜色的所有商品，再取这些商品的所有颜色。【原search.json逻辑中有提前聚合：去除color参数去聚合】
返回示例：

5、获取风格层面的聚合结果
接口：http://192.168.102.216:8080/yohosearch/productindex/aggStyle.json?style=1106&query=耐克鞋
参数：同搜索通用参数
备注：如果传了style，则先过滤出该风格下的所有商品，再取这些商品的所有风格。【原search.json逻辑中有提前聚合：去除style参数去聚合】
返回示例：

6、获取品牌层面的聚合结果
接口：http://192.168.102.216:8080/yohosearch/productindex/aggBrand.json?brand=144
参数：同搜索通用参数
备注：如果传了brand，则只会聚合出该品牌。【原search.json逻辑中有提前聚合：去除brand参数去聚合】
返回示例：

7、获取规则层面的聚合结果
接口：http://192.168.102.216:8080/yohosearch/productindex/aggStandard.json?parameter_787=4439
参数：同搜索通用参数
备注：如果传了parameter_xxx，则先用parameter_xxx过滤，再聚合出商品的规则信息。
返回示例：

8、获取尺码层面的聚合结果
接口：http://192.168.102.216:8080/yohosearch/productindex/aggSize.json?size=1
参数：同搜索通用参数
备注：如果传了size，则先用size过滤，再聚合出商品的尺码信息。【以前的search.json请求参数里没有size参数的时候才会去聚合尺码】
返回示例：

9、获取是否新品的聚合结果
接口：http://192.168.102.216:8080/yohosearch/productindex/aggNew.json
参数：同搜索通用参数
备注：根据参数过滤出来的商品，只要有一个商品是new，则整个聚合结果为true
返回示例：

10、获取是否限量的聚合结果
接口：http://192.168.102.216:8080/yohosearch/productindex/aggLimited.json
参数：同搜索通用参数
备注：根据参数过滤出来的商品，只要有一个商品是limited，则整个聚合结果为true
返回示例：

11、获取是否特价的聚合结果
接口：http://192.168.102.216:8080/yohosearch/productindex/aggSpecialoffer.json
参数：同搜索通用参数
备注：根据参数过滤出来的商品，只要有一个商品是isSpecialoffer，则整个聚合结果为true
返回示例：

12、获取商品列表
接口：http://192.168.102.216:8080/yohosearch/productindex/productList.json
参数：同搜索通用参数
备注：拿参数去过滤，total表示商品总数【参数viewNum默认显示10条】
返回示例：

13、获取商品数量
接口：http://192.168.102.216:8080/yohosearch/productindex/productCount.json
参数：同搜索通用参数
备注：拿参数去过滤，total表示商品总数
返回示例：