西故山 > 美食 > 食材 > 蘑菇街 API

蘑菇街 API

来源：网络转载 2017-05-25 10:47 编辑： www.xigushan.com 查看: 次

本API专门为黑客马拉松编程大赛（杭州）准备，大赛结束后将暂时关闭。后续我们会正式开放完整的API，敬请期待。
有任何的疑问或建议请联系open#mogujie.com（#请替换为@）。

商品搜索接口

1.接口说明

搜索蘑菇街站内商品。

2.请求说明

接口名称（method） items.search

请求地址

HTTP请求方式 GET或POST

编码 UTF-8

安全校验不需要

3.请求参数

参数参数类型是否可选说明

method
String 必选接口名称

keyword String
可选搜索关键字

category Int 可选类目ID，详见附录3.1.

sort String
可选，默认为pop 排序方式，详见附录3.2.

minPrice
Int
可选最低价格

maxPrice
Int 可选最高价格

color String
可选
颜色ID，详见附录3.3.

page Int
可选
页码

style String
可选lady或girl
商品风格

附录3.1.类目ID对应表

类目类目级别类目ID（category）

衣服一级类目 16

上装二级类目 17

裤子二级类目 35

裙子二级类目 44

内衣/家居服二级类目 54

鞋子一级类目 85

家居鞋二级类目 86

运动鞋二级类目 88

帆布鞋二级类目 89

板鞋/休闲鞋二级类目 90

靴子二级类目 91

凉鞋二级类目 92

单鞋二级类目 93

雨鞋二级类目 94

包包一级类目
120

包袋二级类目
121

钱包卡套二级类目
122

旅行箱二级类目
123

双肩背包二级类目
124

数码包二级类目
125

相机包二级类目
126

购物袋/环保袋二级类目
127

化妆包二级类目
128

休闲包二级类目
129

配饰一级类目
95

服饰配件二级类目
96

首饰二级类目
105

眼镜二级类目
116

手表二级类目
119

家居一级类目
192

家庭收纳用具二级类目
193

装点生活二级类目
200

毛绒布艺二级类目
207

餐具二级类目
213

厨房二级类目
218

杯具二级类目
223

电子二级类目
231

文具二级类目
245

手工二级类目
261

卫浴二级类目
265

玩偶二级类目
314

器皿二级类目
315

美妆一级类目
130

个人护理二级类目
131

彩妆二级类目
164

附录3.2.排序方式

pop 默认排序

new 新商品优先

hot 热门商品优先

附录3.3.颜色ID对应表

颜色 RGB色值颜色ID

黄色 #fdf343 fdf343

姜黄 #fee050 fee050

蓝色 #17b4dd 17b4dd

牛仔蓝 #0d497b 0d497b

宝蓝 #1ea0dc 1ea0dc

大红 #f24753 f24753

绿色 #374f36 374f36

军绿 #4c5f0d 4c5f0d

棕色 #bd7518 bd7518

驼色 #e6b561 e6b561

裸色 #fadcc3 fadcc3

卡其 #edcaac edcaac

巧克力色 #ae5624 ae5624

米白 #d9d2c9 d9d2c9

白色 #ffffff ffffff

橘色 #f9ac27 f9ac27

藏蓝 #1aafd6 1aafd6

玫红 #e72494 e72494

灰色 #aaaaaa aaaaaa

黑色 #4c4c4c 4c4c4c

4.请求方式

HTTP方式 POST或GET

编码参数值需要urlencode编码

请求样例 ?method=items.search&keyword=%e6%af%9b%e8%a1%a3&category=16&sort=hot&minPrice=50&maxPrice=100&color=f24753

5.返回结果

编码 UTF-8

数据格式 JSON

数据样例：

{ "code":0, "message":"success", "data": { "itemsCount":20000, "pagesCount":200, "page":1, "items": [ { "id":"18drhjw", "title":"\u9a91\u58eb&\u516c\u4e3b\2012\u5916\u8d38\u539f", "price":660, "cover":"http:\/\/s4.mogujie.cn\/b7\/bao\/121016\/hqvi2_kqywinkwm5beg2cugfjeg5sckzsew_233x310.jpg_225x999.jpg", "url":"http:\/\/www.mogujie.com\/note\/18drhjw?showtype=good&goodsid=13ohveg&p=p", "favCount":23， "commentCount":4 } ] } }

6.结果说明 { "code":错误代码，0表示无错误, "message":状态信息, "data":主体数据 { "itemsCount":商品数, "pagesCount":页数, "page":当前页数, "items":商品数组 [ { "id":商品ID, "title":商品标题, "price":价格, "cover":封面图片, "url":商品链接, "favCount":商品喜欢数， "commentCount": 评论数 } ] } }

7.Code对照表

Code 说明

0 请求正常

1001 错误的参数

3001 系统错误

4001 不存在相关数据

4002 指定的类目ID不存在

4003 指定的排序方式不存在

4004 指定的颜色不存在

4005 指定的商品风格不存在