|
...
|
...
|
@@ -12,9 +12,10 @@ |
|
|
|
|
|
|
|
## 1. 搜索商品接口
|
|
|
|
## 1.1 请求
|
|
|
|
|
|
|
|
### 1.1.1 URL格式
|
|
|
|
|
|
|
|
[link text]:http://{host}:{port}/yohosearch/search.json?query={searchquery}&order={orderby hot,new}&……
|
|
|
|
http://{host}:{port}/yohosearch/search.json?query={searchquery}&order={orderby hot,new}&……
|
|
|
|
|
|
|
|
host：服务器地址；
|
|
|
|
|
|
...
|
...
|
@@ -25,101 +26,34 @@ yohosearch：服务实例名； |
|
|
|
search：查询接口名称
|
|
|
|
|
|
|
|
其他参数见1.1.2
|
|
|
|
|
|
|
|
1.1.2
|
|
|
|
### 1.1.2
|
|
|
|
|名称|说明|可空|
|
|
|
|
|
|
|
|
|----|----|-----|
|
|
|
|
|
|
|
|
|query| 关键字| 是|
|
|
|
|
|
|
|
|
|order|排序类型
|
|
|
|
格式：排序字段名:排序方式，如按销量正序排“sales_num:asc”
|
|
|
|
多重排序以逗号分隔，如“order=sales_num:asc, shelve_time:desc”
|
|
|
|
order=discount_score:desc折扣专场score排序
|
|
|
|
|是|
|
|
|
|
|
|
|
|
|page|页数
|
|
|
|
默认为1
|
|
|
|
|是|
|
|
|
|
|
|
|
|
|viewNum|每页记录数参数说明
|
|
|
|
默认为10
|
|
|
|
|是|
|
|
|
|
|
|
|
|
|brand|品牌ID|是|
|
|
|
|
|
|
|
|
||查多个品牌以逗号分隔||
|
|
|
|
|
|
|
|
|msort| 产品大分类ID
|
|
|
|
查多个大类以逗号分隔| 是
|
|
|
|
|
|
|
|
|
|
|
|
|
|misort |产品中分类ID
|
|
|
|
查多个中类以逗号分隔| 是
|
|
|
|
|
|
|
|
|
|
|
|
|
|sort |查询小分类ID
|
|
|
|
查多个小类以逗号分隔| 是
|
|
|
|
|
|
|
|
|
|
|
|
|
|gender| 性别
|
|
|
|
1-男
|
|
|
|
2-女
|
|
|
|
3-通用
|
|
|
|
查多个性别以逗号分隔| 是
|
|
|
|
|
|
|
|
|
|
|
|
|
|price| 价格区间
|
|
|
|
起始价格以逗号分隔，如查询300-600元“price=300,600”| 是
|
|
|
|
|
|
|
|
|
|
|
|
|
|color |颜色ID
|
|
|
|
查多个颜色以逗号分隔| 是
|
|
|
|
|
|
|
|
|
|
|
|
|
|size |尺码ID
|
|
|
|
查多个尺码以逗号分隔| 是
|
|
|
|
|
|
|
|
|
|
|
|
|
|style| 风格ID
|
|
|
|
查多个风格以逗号分隔| 是
|
|
|
|
|
|
|
|
|
|
|
|
|
|parameter_xxx| 属性类型ID与值ID
|
|
|
|
参数名称格式：parameter_{属性类型ID}={属性值ID}，如查询厚度为中“parameter_875=4801”| 是
|
|
|
|
|
|
|
|
|
|
|
|
|
|stocknumber| 库存量
|
|
|
|
如“stocknumber=2”，则过滤出库存量>=2的商品| 是
|
|
|
|
|
|
|
|
|
|
|
|
|
|shelve_time| 时间区间
|
|
|
|
起始时间以逗号分隔，如查询20150101-20150106 “shelve_time =1420041600,1420473600”| 是
|
|
|
|
|
|
|
|
|
|
|
|
|
|first_shelve_time| 时间区间
|
|
|
|
起始时间以逗号分隔，如查询20150101-20150106 “first_shelve_time =1420041600,1420473600” |是
|
|
|
|
|
|
|
|
|
|
|
|
|
|needFilter| 需要返回过滤集合
|
|
|
|
needFilter=1 |是
|
|
|
|
|
|
|
|
|
|
|
|
|
|specialoffer| 特价类型| 是|
|
|
|
|
|
|
|
|
|sales |是否销售“N”或“Y” |是|
|
|
|
|
|
|
|
|
|promotion| 促销id | 是|
|
|
|
|
|
|
|
|
|vdt| Vip折扣类型 |是|
|
|
|
|
|
|
|
|
|p_d| 促销折扣浮点值如0.7 |是|
|
|
|
|
|
|
|
|
|attribute| 商品属性 1正常商品 2赠品 |是|
|
|
|
|
|
|
|
|
|limited 是否限量 “N”或“Y”| 是|
|
|
|
|
|
|
|
|
|order|排序类型格式：排序字段名:排序方式，如按销量正序排“sales_num:asc” 多重排序以逗号分隔，如“order=sales_num:asc, shelve_time:desc” order=discount_score:desc折扣专场score排序|是|
|
|
|
|
|page|页数 默认为1|是|
|
|
|
|
|viewNum|每页记录数参数说明 默认为10|是|
|
|
|
|
|brand|品牌ID,查多个品牌以逗号分隔|是|
|
|
|
|
|msort| 产品大分类ID 查多个大类以逗号分隔|是|
|
|
|
|
|misort |产品中分类ID 查多个中类以逗号分隔|是|
|
|
|
|
|sort|查询小分类ID 查多个小类以逗号分隔|是|
|
|
|
|
|gender|性别 1-男 2-女 3-通用 查多个性别以逗号分隔|是|
|
|
|
|
|price| 价格区间 起始价格以逗号分隔，如查询300-600元“price=300,600”|是|
|
|
|
|
|color|颜色ID 查多个颜色以逗号分隔|是|
|
|
|
|
|size|尺码ID 查多个尺码以逗号分隔|是|
|
|
|
|
|style| 风格ID 查多个风格以逗号分隔|是|
|
|
|
|
|parameter_xxx| 属性类型ID与值ID 参数名称格式：parameter_{属性类型ID}={属性值ID}，如查询厚度为中“parameter_875=4801”|是|
|
|
|
|
|stocknumber|库存量 如“stocknumber=2”，则过滤出库存量>=2的商品|是|
|
|
|
|
|shelve_time|时间区间 上架时间以逗号分隔，如查询20150101-20150106 “shelve_time =1420041600,1420473600”| 是|
|
|
|
|
|first_shelve_time| 时间区间 上架起始时间以逗号分隔，如查询20150101-20150106 “first_shelve_time =1420041600,1420473600” |是|
|
|
|
|
|needFilter|需要返回过滤集合needFilter=1|是|
|
|
|
|
|specialoffer|特价类型|是|
|
|
|
|
|sales |是否销售“N”或“Y”|是|
|
|
|
|
|promotion| 促销id |是|
|
|
|
|
|vdt|Vip折扣类型|是|
|
|
|
|
|p_d|促销折扣浮点值如0.7|是|
|
|
|
|
|attribute| 商品属性 1正常商品 2赠品|是|
|
|
|
|
|limited |是否限量 “N”或“Y”| 是|
|
|
|
|
|new| 是否新品“N”或“Y”| 是|
|
|
|
|
|
|
|
|
|status| 是否上架 1 或 2 |是|
|
...
|
...
|
|
