Authored by 马力

商品池搜索接口文档

  1 +## 1、根据商品池的信息查询过滤商品列表
  2 +### (method=app.search.pool,获取商品池商品列表)
  3 +
  4 +#### 请求参数
  5 +| 名称 | 类型 | 是否必须 | 示例值 | 默认值 | 描述 |
  6 +| :-- | :-- | :-- | :-- | :-- | :-- |
  7 +| method | String | 是 | app.search.pool| |请求方法|
  8 +| limit | int | 否 | 10 ||每页展示条数,默认10条|
  9 +| sort | String | 否 | "116,117,115,119,124,122,413,258,173,227,125,118,121,123,114,293" ||查询小分类ID,查多个小类以逗号分隔|
  10 +| page | int | 否 | 1 ||当前页|
  11 +| yh_channel | String | 否 | "1" ||频道|
  12 +| order | String | 否 | "s_t_desc" ||排序信息 |
  13 +| p_d | String | 否 | "0.7" ||打折区间,以逗号分隔|
  14 +| color | String | 否 | "145" ||颜色ID|
  15 +| brand | String | 否 | "125" ||品牌ID|
  16 +| price | String | 否 | "300,600" ||价格区间,以逗号分隔|
  17 +| size | String | 否 | "16,17" ||尺寸ID,以逗号分隔|
  18 +| standard | String[] | 否 | standard=13&standard=25 ||规格|
  19 +| gender | String | 否 | "1,3" ||性别,以逗号分隔|
  20 +| outlets | int | 否 | 1 ||outlets=1 奥莱商品 outlets=2非奥莱商品|
  21 +| app_type | int | 否 | 0 ||0 代表有货商品 1 代表BLK商品|
  22 +| age_level | int | 否 | null ||1成人 2 大童 3小童,多值则用英文逗号分隔|
  23 +#### 注意:与以前方式兼容,如果筛选奥莱,只需增加outlets=1的请求参数
  24 +
  25 +### 响应
  26 +code为200即为成功且只会返回200,每次都会有响应结果。
  27 +响应JSON格式如下所示:
  28 +```json
  29 +{
  30 + "alg": "SALT_MD5",
  31 + "code": 200,
  32 + "data": {
  33 + "filter": {
  34 + "gender": {
  35 + "1,3": "BOYS",
  36 + "2,3": "GIRLS"
  37 + },
  38 + "color": [
  39 + {
  40 + "color_id": 1,
  41 + "color_name": "白色",
  42 + "color_value": "",
  43 + "color_code": "FFFFFF"
  44 + },
  45 + {
  46 + "color_id": 11,
  47 + "color_name": "红色",
  48 + "color_value": "",
  49 + "color_code": "ee0000"
  50 + },
  51 + {
  52 + "color_id": 13,
  53 + "color_name": "银色",
  54 + "color_value": "http://static.yohobuy.com/images/color_p2.png",
  55 + "color_code": ""
  56 + },
  57 + {
  58 + "color_id": 2,
  59 + "color_name": "黑色",
  60 + "color_value": "",
  61 + "color_code": "333333"
  62 + },
  63 + {
  64 + "color_id": 6,
  65 + "color_name": "绿色",
  66 + "color_value": "",
  67 + "color_code": "47ba17"
  68 + },
  69 + {
  70 + "color_id": 9,
  71 + "color_name": "黄色",
  72 + "color_value": "",
  73 + "color_code": "ffeb00"
  74 + },
  75 + {
  76 + "color_id": 12,
  77 + "color_name": "橙色",
  78 + "color_value": "",
  79 + "color_code": "ff5c01"
  80 + },
  81 + {
  82 + "color_id": 14,
  83 + "color_name": "金色",
  84 + "color_value": "",
  85 + "color_code": "FFD83D"
  86 + },
  87 + {
  88 + "color_id": 3,
  89 + "color_name": "灰色",
  90 + "color_value": "",
  91 + "color_code": "b9b7af"
  92 + },
  93 + {
  94 + "color_id": 4,
  95 + "color_name": "棕色",
  96 + "color_value": "",
  97 + "color_code": "8b5402"
  98 + },
  99 + {
  100 + "color_id": 7,
  101 + "color_name": "蓝色",
  102 + "color_value": "",
  103 + "color_code": "0000fe"
  104 + },
  105 + {
  106 + "color_id": 8,
  107 + "color_name": "紫色",
  108 + "color_value": "",
  109 + "color_code": "710098"
  110 + }
  111 + ],
  112 + "size": [
  113 + {
  114 + "size_name": "F",
  115 + "size_id": 199
  116 + },
  117 + {
  118 + "size_name": "39码",
  119 + "size_id": 109
  120 + },
  121 + {
  122 + "size_name": "40码",
  123 + "size_id": 116
  124 + },
  125 + {
  126 + "size_name": "41码",
  127 + "size_id": 122
  128 + },
  129 + {
  130 + "size_name": "42码",
  131 + "size_id": 125
  132 + },
  133 + {
  134 + "size_name": "43码",
  135 + "size_id": 129
  136 + },
  137 + {
  138 + "size_name": "44码",
  139 + "size_id": 133
  140 + },
  141 + {
  142 + "size_name": "L",
  143 + "size_id": 201
  144 + },
  145 + {
  146 + "size_name": "M",
  147 + "size_id": 203
  148 + },
  149 + {
  150 + "size_name": "XL",
  151 + "size_id": 211
  152 + }
  153 + ],
  154 + "discount": {
  155 + "0.7,0.999": {
  156 + "name": "7~9",
  157 + "count": 7
  158 + }
  159 + },
  160 + "style": [
  161 + {
  162 + "style_id": 991,
  163 + "style_name": "街头"
  164 + },
  165 + {
  166 + "style_id": 990,
  167 + "style_name": "户外"
  168 + },
  169 + {
  170 + "style_id": 999,
  171 + "style_name": "学院"
  172 + }
  173 + ],
  174 + "brand": [
  175 + {
  176 + "hot_keyword": "oasso",
  177 + "brand_domain": "oasso",
  178 + "brand_alif": "O",
  179 + "is_hot": "N",
  180 + "brand_ico": "http://img12.static.yhbimg.com/brandLogo/2011/11/11/09/0277145affaf6603a366a5e582a3f5161f.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",
  181 + "brand_name": "oasso",
  182 + "id": 210,
  183 + "brand_keyword": "时尚家居用品",
  184 + "brand_name_en": "oasso",
  185 + "brand_name_cn": "瓯粟家居"
  186 + },
  187 + {
  188 + "hot_keyword": "OOU!",
  189 + "brand_domain": "oou",
  190 + "brand_alif": "O",
  191 + "is_hot": "N",
  192 + "brand_ico": "http://img11.static.yhbimg.com/brandLogo/2011/06/26/14/01e09d38d67d7a22097121177fbed23668.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",
  193 + "brand_name": "OOU!",
  194 + "id": 105,
  195 + "brand_keyword": "OOU!",
  196 + "brand_name_en": "OOU!",
  197 + "brand_name_cn": "OOU!"
  198 + },
  199 + {
  200 + "hot_keyword": "Paul&Reed",
  201 + "brand_domain": "paulandreed",
  202 + "brand_alif": "P",
  203 + "is_hot": "N",
  204 + "brand_ico": "http://img13.static.yhbimg.com/brandLogo/2011/06/26/14/02dce1ad9690a3e5ba7e74c5870758776b.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",
  205 + "brand_name": "Paul&Reed",
  206 + "id": 109,
  207 + "brand_keyword": "Paul&Reed",
  208 + "brand_name_en": "Paul&Reed",
  209 + "brand_name_cn": "Paul&Reed"
  210 + },
  211 + {
  212 + "hot_keyword": "Outdo Zenith",
  213 + "brand_domain": "outdozenith",
  214 + "brand_alif": "O",
  215 + "is_hot": "N",
  216 + "brand_ico": "http://img12.static.yhbimg.com/brandLogo/2015/12/07/11/021af17ebb9352667b6114b0792e707a71.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",
  217 + "brand_name": "Outdo Zenith",
  218 + "id": 183,
  219 + "brand_keyword": "Outdo Zenith,拖鞋",
  220 + "brand_name_en": "Outdo Zenith",
  221 + "brand_name_cn": "Outdo Zenith"
  222 + }
  223 + ],
  224 + "priceRange": {
  225 + "0,29": "¥0-29",
  226 + "30,229": "¥30-229",
  227 + "230,99999": "¥229以上"
  228 + },
  229 + "ageLevel": [
  230 + {
  231 + "product_count": 7,
  232 + "name": "成人",
  233 + "id": "1"
  234 + }
  235 + ],
  236 + "group_sort": [
  237 + {
  238 + "category_id": "20",
  239 + "category_name": "家居生活",
  240 + "node_count": 0,
  241 + "parent_id": "4",
  242 + "relation_parameter": {
  243 + "sort": "270,292,271,272,273,274,275,110,276,353,277,332,112,333,355,399,281,184,343,267,344,268,269,302,304"
  244 + },
  245 + "sort_ico": "http://img12.static.yhbimg.com/taobaocms/2016/04/25/15/02c73b1ed1dcf65b22bb1c752ceaf1a9a2.png",
  246 + "sub": [
  247 + {
  248 + "category_id": "140",
  249 + "category_name": "居家",
  250 + "node_count": 0,
  251 + "parent_id": "20",
  252 + "relation_parameter": {
  253 + "sort": "268,269,270,271,272,273,274,275,276,277,332,333,353"
  254 + },
  255 + "sort_ico": ""
  256 + }
  257 + ]
  258 + },
  259 + {
  260 + "category_id": "11",
  261 + "category_name": "鞋靴",
  262 + "node_count": 0,
  263 + "parent_id": "1",
  264 + "relation_parameter": {
  265 + "sort": "231,299,147,148,149,228"
  266 + },
  267 + "sort_ico": "http://img11.static.yhbimg.com/taobaocms/2015/09/01/14/01a4c4324531f3e0c857e5605410110baa.jpg",
  268 + "sub": [
  269 + {
  270 + "category_id": "119",
  271 + "category_name": "靴子",
  272 + "node_count": 0,
  273 + "parent_id": "11",
  274 + "relation_parameter": {
  275 + "sort": "148"
  276 + },
  277 + "sort_ico": ""
  278 + }
  279 + ]
  280 + },
  281 + {
  282 + "category_id": "18",
  283 + "category_name": "上衣",
  284 + "node_count": 0,
  285 + "parent_id": "2",
  286 + "relation_parameter": {
  287 + "sort": "293,173,121,122,123,124,125,114,258,115,116,413,227,117,118,119"
  288 + },
  289 + "sort_ico": "http://img12.static.yhbimg.com/taobaocms/2016/04/25/15/021f6d7c1a73dd5823c6758186ef270611.png",
  290 + "sub": [
  291 + {
  292 + "category_id": "42",
  293 + "category_name": "毛衣/针织",
  294 + "node_count": 0,
  295 + "parent_id": "18",
  296 + "relation_parameter": {
  297 + "sort": "258"
  298 + },
  299 + "sort_ico": "http://img12.static.yhbimg.com/taobaocms/2015/09/01/14/02d48022e08742f1c96766caa6484593ce.jpg?imageView/{mode}/w/{width}/h/{height}"
  300 + }
  301 + ]
  302 + }
  303 + ]
  304 + },
  305 + "standard": [
  306 + {
  307 + "standard_id": "921",
  308 + "sub": [
  309 + {
  310 + "standard_id": "5018",
  311 + "standard_name": "登山靴"
  312 + }
  313 + ],
  314 + "standard_name": "经典款型"
  315 + },
  316 + {
  317 + "standard_id": "871",
  318 + "sub": [
  319 + {
  320 + "standard_id": "4786",
  321 + "standard_name": "v领"
  322 + }
  323 + ],
  324 + "standard_name": "领型"
  325 + }
  326 + ],
  327 + "total": 7,
  328 + "page_total": 7,
  329 + "page": 1,
  330 + "product_list": [
  331 + {
  332 + "small_sort_id": 267,
  333 + "vip1_price": 27.549999999999997,
  334 + "gender": "3",
  335 + "vip3_price": 25.52,
  336 + "is_global": "N",
  337 + "is_outlets": 2,
  338 + "is_discount": "Y",
  339 + "brand_domain": "oasso",
  340 + "is_special": "N",
  341 + "goods_list": [
  342 + {
  343 + "color_id": "1",
  344 + "product_skc": "15984",
  345 + "cover_1": "",
  346 + "goods_id": "15984",
  347 + "images_url": "http://img11.static.yhbimg.com/goodsimg/2012/04/06/13/0114e38c9291eb4c0d56a3e9369681f276.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",
  348 + "color_name": "白",
  349 + "cover_2": "",
  350 + "color_value": "",
  351 + "is_default": "N",
  352 + "color_code": "FFFFFF",
  353 + "status": "1"
  354 + }
  355 + ],
  356 + "vip_discount_type": 3,
  357 + "product_id": 11596,
  358 + "is_advance": "N",
  359 + "sales_num": 259,
  360 + "sales_phrase": "A梦开始的地方 B足迹 C蓝色畅想曲 D心愿 熊猫马克杯四部曲,四款代表不同的故事,每个故事都会带给你不同的体验。 有货随机发送,看看我们会带你进入哪段精彩旅程吧?",
  361 + "cn_alphabet": "OASSOCM1103ABCDXiongMaoBei",
  362 + "product_skn": 50015357,
  363 + "shelve_time": 1452044520,
  364 + "vip2_price": 26.1,
  365 + "age_level": "1",
  366 + "is_student_price": "N",
  367 + "edit_time": 1445318856,
  368 + "is_new": "N",
  369 + "is_limited": "N",
  370 + "brand_name": "oasso",
  371 + "max_sort_id": 10,
  372 + "product_name": "OASSO 熊猫杯",
  373 + "brand_id": 210,
  374 + "tags": [ ],
  375 + "default_images": "http://img11.static.yhbimg.com/goodsimg/2012/04/06/13/0114e38c9291eb4c0d56a3e9369681f276.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",
  376 + "stock_number": 934,
  377 + "storage_num": 934,
  378 + "is_soon_sold_out": "N",
  379 + "middle_sort_id": 266,
  380 + "sales_price": 29,
  381 + "market_price": 30,
  382 + "is_promotion": 102,
  383 + "vip_price": 0,
  384 + "country_id": 2,
  385 + "status": 1
  386 + }
  387 + ]
  388 + },
  389 + "md5": "3862b043e336c9c41e2a14fa5092b95c",
  390 + "message": "pool Product List."
  391 +}
  392 +```