根据商品分类获取前台商品列表页

接口描述：

• 根据商品分类获取前台商品列表页。

请求 URL：

• http|https://host/api/v1/goods/method/get.goods.index.list/

请求方式：

• GET
• POST

是否授权：

• 否

业务参数：

附属 A： in:goods_id,sales_sum,comment_sum,shop_price,create_time

响应参数：

响应示例：

{
  "status": 200,
  "message": "success",
  "data": {
    "filter_menu": [
      {
        "text": "颜色：黑色、白色",
        "value": [
          1,
          "1",
          "2"
        ],
        "param": "spec_list"
      },
      {
        "text": "屏幕尺寸：13.3英寸",
        "value": [
          3,
          "13.3英寸"
        ],
        "param": "attr_list"
      }
    ],
    "filter_price": [
      {
        "text": "1080以下",
        "value": [
          0,
          1080
        ]
      },
      {
        "text": "5400以内",
        "value": [
          4320,
          5400
        ]
      }
    ],
    "filter_brand": [
      {
        "text": "小米",
        "value": {
          "brand_id": 24,
          "name": "小米",
          "phonetic": "x",
          "logo": ""
        }
      },
      {
        "text": "华为",
        "value": {
          "brand_id": 23,
          "name": "华为",
          "phonetic": "h",
          "logo": ""
        }
      }
    ],
    "filter_spec": [
      {
        "text": "颜色",
        "value": [
          {
            "spec_item_id": 1,
            "spec_id": 1,
            "item_name": "黑色"
          },
          {
            "spec_item_id": 2,
            "spec_id": 1,
            "item_name": "白色"
          }
        ]
      },
      {
        "text": "CPU",
        "value": [
          {
            "spec_item_id": 3,
            "spec_id": 2,
            "item_name": "I5"
          },
          {
            "spec_item_id": 4,
            "spec_id": 2,
            "item_name": "I7"
          }
        ]
      }
    ],
    "filter_attr": [
      {
        "text": "屏幕尺寸",
        "value": [
          {
            "goods_attribute_id": 3,
            "attr_value": "13.3英寸",
            "sort": 50
          },
          {
            "goods_attribute_id": 3,
            "attr_value": "15.6英寸",
            "sort": 50
          }
        ]
      },
      {
        "text": "显卡类别",
        "value": [
          {
            "goods_attribute_id": 4,
            "attr_value": "独立显卡",
            "sort": 40
          }
        ]
      }
    ],
    "filter_cate": [
      {
        "goods_category_id": 1,
        "parent_id": 0,
        "name": "手机 、 数码 、 通信",
        "name_phonetic": "s",
        "alias": "数码产品",
        "alias_phonetic": "s",
        "category_pic": "",
        "category_ioc": "",
        "keywords": "",
        "description": "",
        "category_type": 0,
        "sort": 50,
        "is_navi": 0,
        "status": 1,
        "children_total": 8,
        "level": 0
      },
      {
        "goods_category_id": 3,
        "parent_id": 0,
        "name": "电脑、办公",
        "name_phonetic": "d",
        "alias": "电脑",
        "alias_phonetic": "d",
        "category_pic": "",
        "category_ioc": "",
        "keywords": "",
        "description": "",
        "category_type": 0,
        "sort": 50,
        "is_navi": 0,
        "status": 1,
        "children_total": 7,
        "level": 0
      }
    ],
    "items": [
      {
        "goods_id": 14,
        "name": "小米笔记本 白色",
        "short_name": "mi",
        "product_name": "",
        "brand_id": 24,
        "store_qty": 200,
        "comment_sum": 0,
        "sales_sum": 0,
        "is_postage": 1,
        "market_price": 7000,
        "shop_price": 5400,
        "least_sum": 1,
        "purchase_sum": 2,
        "attachment": [
          "//image_1.jpg"
        ],
        "video": "//video.mp4",
        "is_recommend": 1,
        "is_new": 1,
        "is_hot": 1,
        "sort": 50
      },
      {
        "goods_id": 13,
        "name": "MateBook 华为 笔记本",
        "short_name": "MateBook",
        "product_name": "XXX促销",
        "brand_id": 23,
        "store_qty": 200,
        "comment_sum": 0,
        "sales_sum": 0,
        "is_postage": 1,
        "market_price": 7000,
        "shop_price": 5400,
        "least_sum": 1,
        "purchase_sum": 2,
        "attachment": [
          "//image_1.jpg"
        ],
        "video": "//video.mp4",
        "is_recommend": 1,
        "is_new": 1,
        "is_hot": 1,
        "sort": 50
      }
    ],
    "total_result": 2
  }
}

备注:

1. 该接口支持条件搜索，如果不带入业务参数则使用默认值。

2. 参数keywords支持多个关键词，但只支持空格间隔。如需更高级搜索支持，请自行部署全文索引。

3. 参数filter_brand、filter_spec、filter_attr允许多选筛选。

4. 参数filter_brand进行筛选比较简单，只需要一个数组即可，而filter_spec、filter_attr筛选前先了解下概念。

   1. 以规格举例，规格是一个大的总体，比如『颜色』、『尺寸』、『CPU』，在一个『CPU』下可以有『I5』『I7』等规格项，属性也是同等道理。

   2. 根据响应示例返回的值，我们现在进行字段代入。

      1. 以规格举例。规格等同于字段spec_id，规格项等同于字段spec_item_id。
      2. 以属性举例。属性等同于字段goods_attribute_id，属性项等同于字段attr_value。

   3. 筛选参数spec_list：

      • A：假设筛选的内容是『CPU』，型号只要『I5』的商品。
        • 字段代入：[$spec_id, $spec_item_id]
        • 实际参数：[2, 3]
      • B：假设筛选的内容是『CPU』，型号只要『I5』或『I7』的商品。
        • 字段代入：[$spec_id, $spec_item_id, $spec_item_id]
        • 实际参数：[2, 3, 4]
      • C：假设现在需要在之前的基础上再进行筛选『颜色』,并且需要『黑色』和『白色』的商品。
        • 字段代入：[[$spec_id, $spec_item_id, $spec_item_id], [$spec_id, $spec_item_id, $spec_item_id]]
        • 实际参数：[[2, 3, 4], [1, 1, 2]]

      • 参数$spec_id的值必须在数组的首位。

        小提示：其实对于举例中的 A 和 B 来说，将实际参数直接组合成多维数组在实际操作中会更加方便，比如实际参数：[2, 3]可以改为[[2, 3]]。

   4. 筛选参数attr_list：

      • 假设筛选的内容是『屏幕尺寸』，型号只要『15.6英寸』的商品。

        • 字段代入：[$goods_attribute_id, $attr_value]
        • 实际参数：[3, "15.6英寸"]

      • 参数$goods_attribute_id的值必须在数组的首位，其他的方法和spec_list是一样的。