专辑

Collection API 可用于获取指定 collection id 的 collection 商品或 filters。

所有 Ajax API 请求应使用多语言 URL，以便为访客提供一致的体验。

获取专辑商品列表

GET /{locale}/api/collections/{collection_id}/products

分页获取专辑下的商品。

请求示例

请求示例

fetch(window.SHOPLAZZA.routes.root + '/api/collections/8bc2047d-bf57-4c91-b207-e3480f79800d/products?page=0&limit=5')
  .then((response) => response.json())
  .then((data) => {
    // do something...
  });

请求参数

collection_idstring

专辑的 id。

pagenumber

返回第几页商品。

limitnumber

每页返回的商品数。

响应

数据结构

data object

响应数据主体。

products object[]

商品列表。

Array [

idstring

商品 ID。

titlestring

商品名称。

briefstring

商品的简要描述。

vendorstring

商品的供应商。

vendor_urlstring

商品供应商的链接。

has_only_default_variantboolean

商品是否只有默认款式。

requires_shippingboolean

是否需要物流配送。

taxableboolean

是否需要计税。

inventory_policystring

商品缺货时是否继续销售。

inventory_quantitynumber

库存数量。

inventory_trackingboolean

是否启用库存追踪。

publishedboolean

资源是否已发布。

handlestring

用于资源链接的 handle（URL 友好别名）。

spustring

商品的 SPU（标准产品单元）。

notestring

对象上的备注。

need_variant_imageboolean

款式是否必须单独配图。

fake_salesnumber

商品的虚拟销量。

display_fake_salesboolean

是否在前台展示虚拟销量。

independent_seoboolean

是否独立管理 SEO 设置。

created_atstring

创建时间（ISO-8601 格式）。

updated_atstring

最后更新时间（ISO-8601 格式）。

tagsstring

对象上的标签。

availableboolean

是否可购买。

price_minstring

款式中的最低价格，以店铺主货币单位表示。

price_maxstring

款式中的最高价格，以店铺主货币单位表示。

pricestring

商品价格，以店铺主货币单位表示。

compare_at_pricestring

划线价。

compare_at_price_minstring

款式中的最低划线价。

compare_at_price_maxstring

款式中的最高划线价。

urlstring

商品页的相对地址。

published_atstring

发布时间（ISO-8601 格式）。

salesnumber

销量。

image object

商品的第一张图片。

srcstring

图片的地址。

widthnumber

图片宽度（像素）。

heightnumber

图片高度（像素）。

altstring

图片的替代文本。

pathstring

图片文件在图床上的路径。

aspect_rationumber

图片宽度除以高度得到的宽高比。

meta_titlestring

页面元信息中的 SEO 标题。

meta_descriptionstring

页面元信息中的 SEO 描述。

meta_keywordstring

页面元信息中的 SEO 关键词。

options object[]

商品的属性，例如颜色、尺码。

Array [

idstring

商品属性的 ID。

namestring

商品属性名称，例如 Color。

positionnumber

属性的排序位置。

valuesstring[]

商品属性的可选值列表。

]

variants object[]

商品的款式列表。

Array [

idstring

款式 ID。

titlestring

款式标题，由各属性取值用 - 连接而成。

weight_unitstring

重量单位，例如 kg。

inventory_quantitynumber

库存数量。

skustring

款式的 SKU，用于库存管理。

barcodestring

款式的条形码。

positionnumber

在列表中的排序位置。

option1string

该款式在第一个商品属性上的取值。

option2string

该款式在第二个商品属性上的取值。

option3string

该款式在第三个商品属性上的取值。

notestring

对象上的备注。

image object

款式关联的图片。

srcstring

图片的地址。

widthnumber

图片宽度（像素）。

heightnumber

图片高度（像素）。

altstring

图片的替代文本。

pathstring

图片文件在图床上的路径。

aspect_rationumber

图片宽度除以高度得到的宽高比。

weightstring

款式的重量。

compare_at_pricestring

划线价。

pricestring

款式价格，以店铺主货币单位表示。

availableboolean

是否可购买。

available_quantitynumber

仍可购买的数量。

options object[]

该款式在各商品属性上的取值。

Array [

namestring

商品属性名称，例如 Color。

valuestring

该商品属性被选中的取值。

]

urlstring

选中该款式的商品页相对地址。

off_rationumber

当前适用的折扣比率。

flashsale_infoundefined[]

商品的闪购活动信息。

salesnumber

销量。

wholesale_price object[]

批发价梯度列表。

Array [

pricestring

该批发价梯度的单价。

min_quantitynumber

该批发价梯度要求的最小数量。

]

retail_pricestring

以店铺主货币单位表示的零售价。

]

variants_countnumber

images object[]

商品图片列表。

Array [

srcstring

图片的地址。

widthnumber

图片宽度（像素）。

heightnumber

图片高度（像素）。

altstring

图片的替代文本。

pathstring

图片文件在图床上的路径。

aspect_rationumber

图片宽度除以高度得到的宽高比。

]

flashsale_infoundefined[]

商品的闪购活动信息。

off_rationumber

当前适用的折扣比率。

price_variesboolean

商品的各款式价格是否不同。

ifbstring

cfbstring

sspstring

scmstring

mixed_wholesaleboolean

是否支持混批。

retail_pricestring

以店铺主货币单位表示的零售价。

retail_price_minstring

款式中的最低零售价。

retail_price_maxstring

款式中的最高零售价。

min_price_variant object

价格最低的款式。

idstring

款式 ID。

titlestring

款式标题，由各属性取值用 - 连接而成。

weight_unitstring

重量单位，例如 kg。

inventory_quantitynumber

库存数量。

skustring

款式的 SKU，用于库存管理。

barcodestring

款式的条形码。

positionnumber

在列表中的排序位置。

option1string

该款式在第一个商品属性上的取值。

option2string

该款式在第二个商品属性上的取值。

option3string

该款式在第三个商品属性上的取值。

notestring

对象上的备注。

imagestring可空

款式关联的图片。

weightstring

款式的重量。

compare_at_pricestring

划线价。

pricestring

款式价格，以店铺主货币单位表示。

availableboolean

是否可购买。

available_quantitynumber

仍可购买的数量。

options object[]

该款式在各商品属性上的取值。

Array [

namestring

商品属性名称，例如 Color。

valuestring

该商品属性被选中的取值。

]

urlstring

选中该款式的商品页相对地址。

off_rationumber

当前适用的折扣比率。

flashsale_infoundefined[]

商品的闪购活动信息。

salesnumber

销量。

wholesale_price object[]

批发价梯度列表。

Array [

pricestring

该批发价梯度的单价。

min_quantitynumber

该批发价梯度要求的最小数量。

]

retail_pricestring

以店铺主货币单位表示的零售价。

product_typestring

商品类型。

descriptionstring

商品描述。

comment_avg_starnumber

商品评价的平均星级。

comment_countnumber

商品的顾客评价数量。

]

has_morenumber

是否还有更多记录。

pagenumber

当前页码。

limitnumber

每页最多返回的记录数。

products_countnumber

匹配到的商品总数。

countnumber

返回的商品数量。

comment_enabledboolean

是否开启了顾客评价。

msgstring

响应返回的结果说明。

statenumber

请求结果标识，success 或 0 表示请求成功。

示例

json

{
  "data": {
    "products": [
      {
        "id": "b3b656ae-504f-4f01-a054-879a610925e3",
        "title": "Sample product",
        "brief": "Sample product",
        "vendor": "",
        "vendor_url": "",
        "has_only_default_variant": false,
        "requires_shipping": true,
        "taxable": false,
        "inventory_policy": "deny",
        "inventory_quantity": 217,
        "inventory_tracking": true,
        "published": true,
        "handle": "Sample product",
        "spu": "1111",
        "note": "",
        "need_variant_image": false,
        "fake_sales": 0,
        "display_fake_sales": false,
        "independent_seo": false,
        "created_at": "2026-06-08T08:12:08Z",
        "updated_at": "2026-08-10T06:53:57Z",
        "tags": "",
        "available": true,
        "price_min": "10",
        "price_max": "90",
        "price": "10",
        "compare_at_price": "20.00",
        "compare_at_price_min": "0.00",
        "compare_at_price_max": "20.00",
        "url": "/products/Sample product",
        "published_at": "2026-07-30T02:28:23Z",
        "sales": 0,
        "image": {
          "src": "//img.staticdj.com/50fa9b8c054f4d11b0d765de5f35dd4e.png",
          "width": 1254,
          "height": 1254,
          "alt": "",
          "path": "50fa9b8c054f4d11b0d765de5f35dd4e.png",
          "aspect_ratio": 1
        },
        "meta_title": "",
        "meta_description": "",
        "meta_keyword": "",
        "options": [
          {
            "id": "5d6c5366-5c4b-4d3b-8ecd-a83d6d5b1abf",
            "name": "Color",
            "position": 1,
            "values": [
              "Black",
              "Red",
              "White"
            ]
          },
          {
            "id": "af2cadff-8ef3-4b10-a9ec-fd92a30cb18c",
            "name": "Size",
            "position": 2,
            "values": [
              "S",
              "M",
              "L"
            ]
          }
        ],
        "variants": [
          {
            "id": "0699bc80-19ae-41bb-87c4-dbcbe5ed90a0",
            "title": "Black-S",
            "weight_unit": "kg",
            "inventory_quantity": 48,
            "sku": "1111-BLACK-S-A001001",
            "barcode": "",
            "position": 1,
            "option1": "Black",
            "option2": "S",
            "option3": "",
            "note": "",
            "image": {
              "src": "",
              "width": 0,
              "height": 0,
              "alt": "",
              "path": "",
              "aspect_ratio": 0
            },
            "weight": "0",
            "compare_at_price": "20",
            "price": "10",
            "available": true,
            "available_quantity": 48,
            "options": [
              {
                "name": "Color",
                "value": "Black"
              },
              {
                "name": "Size",
                "value": "S"
              }
            ],
            "url": "/products/Sample product?variant=0699bc80-19ae-41bb-87c4-dbcbe5ed90a0",
            "off_ratio": 50,
            "flashsale_info": [],
            "sales": 0,
            "wholesale_price": [
              {
                "price": "10",
                "min_quantity": 1
              }
            ],
            "retail_price": "20"
          },
          {
            "id": "e48af6fb-dbec-4efa-9db2-94ad8f8853e4",
            "title": "Black-M",
            "weight_unit": "kg",
            "inventory_quantity": 7,
            "sku": "1111-Black-M-A001002",
            "barcode": "",
            "position": 2,
            "option1": "Black",
            "option2": "M",
            "option3": "",
            "note": "",
            "image": {
              "src": "",
              "width": 0,
              "height": 0,
              "alt": "",
              "path": "",
              "aspect_ratio": 0
            },
            "weight": "0",
            "compare_at_price": "0",
            "price": "20",
            "available": true,
            "available_quantity": 7,
            "options": [
              {
                "name": "Color",
                "value": "Black"
              },
              {
                "name": "Size",
                "value": "M"
              }
            ],
            "url": "/products/Sample product?variant=e48af6fb-dbec-4efa-9db2-94ad8f8853e4",
            "off_ratio": 0,
            "flashsale_info": [],
            "sales": 0,
            "wholesale_price": [
              {
                "price": "20",
                "min_quantity": 1
              }
            ],
            "retail_price": "0"
          },
          {
            "id": "f9a60813-bbec-49db-88d0-3d851a42d696",
            "title": "White-L",
            "weight_unit": "kg",
            "inventory_quantity": 44,
            "sku": "1111-White-L-A001009",
            "barcode": "",
            "position": 9,
            "option1": "White",
            "option2": "L",
            "option3": "",
            "note": "",
            "image": {
              "src": "",
              "width": 0,
              "height": 0,
              "alt": "",
              "path": "",
              "aspect_ratio": 0
            },
            "weight": "0",
            "compare_at_price": "0",
            "price": "90",
            "available": true,
            "available_quantity": 44,
            "options": [
              {
                "name": "Color",
                "value": "White"
              },
              {
                "name": "Size",
                "value": "L"
              }
            ],
            "url": "/products/Sample product?variant=f9a60813-bbec-49db-88d0-3d851a42d696",
            "off_ratio": 0,
            "flashsale_info": [],
            "sales": 0,
            "wholesale_price": [
              {
                "price": "90",
                "min_quantity": 1
              }
            ],
            "retail_price": "0"
          }
        ],
        "variants_count": 9,
        "images": [
          {
            "src": "//img.staticdj.com/50fa9b8c054f4d11b0d765de5f35dd4e.png",
            "width": 1254,
            "height": 1254,
            "alt": "",
            "path": "50fa9b8c054f4d11b0d765de5f35dd4e.png",
            "aspect_ratio": 1
          }
        ],
        "flashsale_info": [],
        "off_ratio": 50,
        "price_varies": true,
        "ifb": "",
        "cfb": "",
        "ssp": "",
        "scm": "",
        "mixed_wholesale": false,
        "retail_price": "20.00",
        "retail_price_min": "0.00",
        "retail_price_max": "20.00",
        "min_price_variant": {
          "id": "0699bc80-19ae-41bb-87c4-dbcbe5ed90a0",
          "title": "Black-S",
          "weight_unit": "kg",
          "inventory_quantity": 48,
          "sku": "1111-BLACK-S-A001001",
          "barcode": "",
          "position": 1,
          "option1": "Black",
          "option2": "S",
          "option3": "",
          "note": "",
          "image": null,
          "weight": "0",
          "compare_at_price": "20",
          "price": "10",
          "available": true,
          "available_quantity": 48,
          "options": [
            {
              "name": "Color",
              "value": "Black"
            },
            {
              "name": "Size",
              "value": "S"
            }
          ],
          "url": "/products/Sample product?variant=0699bc80-19ae-41bb-87c4-dbcbe5ed90a0",
          "off_ratio": 50,
          "flashsale_info": [],
          "sales": 0,
          "wholesale_price": [
            {
              "price": "10",
              "min_quantity": 1
            }
          ],
          "retail_price": "20"
        },
        "product_type": "",
        "description": "",
        "comment_avg_star": 0,
        "comment_count": 0
      },
      {
        "id": "79f46343-605c-4100-a9d5-d8a11dae3fef",
        "title": "Cozy Knit Tee",
        "brief": "",
        "vendor": "",
        "vendor_url": "",
        "has_only_default_variant": true,
        "requires_shipping": true,
        "taxable": false,
        "inventory_policy": "deny",
        "inventory_quantity": 109,
        "inventory_tracking": true,
        "published": true,
        "handle": "cozy-knit-tee",
        "spu": "",
        "note": "",
        "need_variant_image": false,
        "fake_sales": 0,
        "display_fake_sales": false,
        "independent_seo": false,
        "created_at": "2026-06-24T06:17:25Z",
        "updated_at": "2026-08-04T06:58:45Z",
        "tags": "",
        "available": true,
        "price_min": "105",
        "price_max": "105",
        "price": "105",
        "compare_at_price": "0.00",
        "compare_at_price_min": "0.00",
        "compare_at_price_max": "0.00",
        "url": "/products/cozy-knit-tee",
        "published_at": "2026-07-30T02:17:25Z",
        "sales": 0,
        "image": {
          "src": "//img.staticdj.com/66dde64782015ee2e4f31a1e08781d92.svg",
          "width": 1,
          "height": 1,
          "alt": "",
          "path": "66dde64782015ee2e4f31a1e08781d92.svg",
          "aspect_ratio": 1
        },
        "meta_title": "",
        "meta_description": "",
        "meta_keyword": "",
        "options": [],
        "variants": [
          {
            "id": "e660a2bc-c8ec-44ef-a3ab-028d317eedd9",
            "title": "",
            "weight_unit": "kg",
            "inventory_quantity": 109,
            "sku": "",
            "barcode": "",
            "position": 1,
            "option1": "",
            "option2": "",
            "option3": "",
            "note": "",
            "image": {
              "src": "",
              "width": 0,
              "height": 0,
              "alt": "",
              "path": "",
              "aspect_ratio": 0
            },
            "weight": "0",
            "compare_at_price": "0",
            "price": "105",
            "available": true,
            "available_quantity": 109,
            "options": [],
            "url": "/products/cozy-knit-tee?variant=e660a2bc-c8ec-44ef-a3ab-028d317eedd9",
            "off_ratio": 0,
            "flashsale_info": [],
            "sales": 0,
            "wholesale_price": [
              {
                "price": "105",
                "min_quantity": 1
              }
            ],
            "retail_price": "0"
          }
        ],
        "variants_count": 1,
        "images": [
          {
            "src": "//img.staticdj.com/66dde64782015ee2e4f31a1e08781d92.svg",
            "width": 1,
            "height": 1,
            "alt": "",
            "path": "66dde64782015ee2e4f31a1e08781d92.svg",
            "aspect_ratio": 1
          }
        ],
        "flashsale_info": [],
        "off_ratio": 0,
        "price_varies": false,
        "ifb": "",
        "cfb": "",
        "ssp": "",
        "scm": "",
        "mixed_wholesale": false,
        "retail_price": "0.00",
        "retail_price_min": "0.00",
        "retail_price_max": "0.00",
        "min_price_variant": {
          "id": "e660a2bc-c8ec-44ef-a3ab-028d317eedd9",
          "title": "",
          "weight_unit": "kg",
          "inventory_quantity": 109,
          "sku": "",
          "barcode": "",
          "position": 1,
          "option1": "",
          "option2": "",
          "option3": "",
          "note": "",
          "image": null,
          "weight": "0",
          "compare_at_price": "0",
          "price": "105",
          "available": true,
          "available_quantity": 109,
          "options": [],
          "url": "/products/cozy-knit-tee?variant=e660a2bc-c8ec-44ef-a3ab-028d317eedd9",
          "off_ratio": 0,
          "flashsale_info": [],
          "sales": 0,
          "wholesale_price": [
            {
              "price": "105",
              "min_quantity": 1
            }
          ],
          "retail_price": "0"
        },
        "product_type": "",
        "description": "",
        "comment_avg_star": 0,
        "comment_count": 0
      },
      {
        "id": "14a309ec-b966-4cf9-a9bb-33baa821fdbc",
        "title": "sample-product",
        "brief": "",
        "vendor": "",
        "vendor_url": "",
        "has_only_default_variant": false,
        "requires_shipping": true,
        "taxable": false,
        "inventory_policy": "",
        "inventory_quantity": 0,
        "inventory_tracking": false,
        "published": true,
        "handle": "sample-product",
        "spu": "",
        "note": "",
        "need_variant_image": false,
        "fake_sales": 0,
        "display_fake_sales": false,
        "independent_seo": false,
        "created_at": "2026-08-10T07:28:24Z",
        "updated_at": "2026-08-25T07:04:00Z",
        "tags": "",
        "available": true,
        "price_min": "1",
        "price_max": "1",
        "price": "1",
        "compare_at_price": "1.00",
        "compare_at_price_min": "1.00",
        "compare_at_price_max": "1.00",
        "url": "/products/sample-product",
        "published_at": "2026-08-10T07:28:24Z",
        "sales": 0,
        "image": {
          "src": "//img.staticdj.com/free/e6e8dc980211cbef103e16371d6e0e61.jpeg",
          "width": 3000,
          "height": 1500,
          "alt": "",
          "path": "free/e6e8dc980211cbef103e16371d6e0e61.jpeg",
          "aspect_ratio": 2
        },
        "meta_title": "",
        "meta_description": "",
        "meta_keyword": "",
        "options": [
          {
            "id": "32da111a-8237-48a7-9779-6bfa6b77f1e7",
            "name": "Size",
            "position": 1,
            "values": [
              "01",
              "02",
              "16"
            ]
          }
        ],
        "variants": [
          {
            "id": "fff360dd-6457-466a-98b3-16878bacef5b",
            "title": "01",
            "weight_unit": "kg",
            "inventory_quantity": 0,
            "sku": "",
            "barcode": "",
            "position": 1,
            "option1": "01",
            "option2": "",
            "option3": "",
            "note": "",
            "image": {
              "src": "",
              "width": 0,
              "height": 0,
              "alt": "",
              "path": "",
              "aspect_ratio": 0
            },
            "weight": "0",
            "compare_at_price": "1",
            "price": "1",
            "available": true,
            "available_quantity": 999999999,
            "options": [
              {
                "name": "Size",
                "value": "01"
              }
            ],
            "url": "/products/sample-product?variant=fff360dd-6457-466a-98b3-16878bacef5b",
            "off_ratio": 0,
            "flashsale_info": [],
            "sales": 0,
            "wholesale_price": [
              {
                "price": "1",
                "min_quantity": 1
              }
            ],
            "retail_price": "1"
          },
          {
            "id": "9063e68e-0f3a-4453-82cd-115727cce51e",
            "title": "02",
            "weight_unit": "kg",
            "inventory_quantity": 0,
            "sku": "",
            "barcode": "",
            "position": 2,
            "option1": "02",
            "option2": "",
            "option3": "",
            "note": "",
            "image": {
              "src": "",
              "width": 0,
              "height": 0,
              "alt": "",
              "path": "",
              "aspect_ratio": 0
            },
            "weight": "0",
            "compare_at_price": "1",
            "price": "1",
            "available": true,
            "available_quantity": 999999999,
            "options": [
              {
                "name": "Size",
                "value": "02"
              }
            ],
            "url": "/products/sample-product?variant=9063e68e-0f3a-4453-82cd-115727cce51e",
            "off_ratio": 0,
            "flashsale_info": [],
            "sales": 0,
            "wholesale_price": [
              {
                "price": "1",
                "min_quantity": 1
              }
            ],
            "retail_price": "1"
          },
          {
            "id": "7d4f540d-31b5-4a59-a406-eb3a981cdee5",
            "title": "16",
            "weight_unit": "kg",
            "inventory_quantity": 0,
            "sku": "",
            "barcode": "",
            "position": 16,
            "option1": "16",
            "option2": "",
            "option3": "",
            "note": "",
            "image": {
              "src": "",
              "width": 0,
              "height": 0,
              "alt": "",
              "path": "",
              "aspect_ratio": 0
            },
            "weight": "0",
            "compare_at_price": "1",
            "price": "1",
            "available": true,
            "available_quantity": 999999999,
            "options": [
              {
                "name": "Size",
                "value": "16"
              }
            ],
            "url": "/products/sample-product?variant=7d4f540d-31b5-4a59-a406-eb3a981cdee5",
            "off_ratio": 0,
            "flashsale_info": [],
            "sales": 0,
            "wholesale_price": [
              {
                "price": "1",
                "min_quantity": 1
              }
            ],
            "retail_price": "1"
          }
        ],
        "variants_count": 16,
        "images": [
          {
            "src": "//img.staticdj.com/free/e6e8dc980211cbef103e16371d6e0e61.jpeg",
            "width": 3000,
            "height": 1500,
            "alt": "",
            "path": "free/e6e8dc980211cbef103e16371d6e0e61.jpeg",
            "aspect_ratio": 2
          },
          {
            "src": "//img.staticdj.com/free/b7addf0790dc3eee7b65c693ba2140df.jpg",
            "width": 2616,
            "height": 1743,
            "alt": "",
            "path": "free/b7addf0790dc3eee7b65c693ba2140df.jpg",
            "aspect_ratio": 1.5008605851979346
          }
        ],
        "flashsale_info": [],
        "off_ratio": 0,
        "price_varies": false,
        "ifb": "",
        "cfb": "",
        "ssp": "",
        "scm": "",
        "mixed_wholesale": false,
        "retail_price": "1.00",
        "retail_price_min": "1.00",
        "retail_price_max": "1.00",
        "min_price_variant": {
          "id": "fff360dd-6457-466a-98b3-16878bacef5b",
          "title": "01",
          "weight_unit": "kg",
          "inventory_quantity": 0,
          "sku": "",
          "barcode": "",
          "position": 1,
          "option1": "01",
          "option2": "",
          "option3": "",
          "note": "",
          "image": null,
          "weight": "0",
          "compare_at_price": "1",
          "price": "1",
          "available": true,
          "available_quantity": 999999999,
          "options": [
            {
              "name": "Size",
              "value": "01"
            }
          ],
          "url": "/products/sample-product?variant=fff360dd-6457-466a-98b3-16878bacef5b",
          "off_ratio": 0,
          "flashsale_info": [],
          "sales": 0,
          "wholesale_price": [
            {
              "price": "1",
              "min_quantity": 1
            }
          ],
          "retail_price": "1"
        },
        "product_type": "",
        "description": "",
        "comment_avg_star": 0,
        "comment_count": 0
      }
    ],
    "has_more": 0,
    "page": 1,
    "limit": 5,
    "products_count": 3,
    "count": 3,
    "comment_enabled": false
  },
  "msg": "请求成功",
  "state": 0
}

筛选专辑商品

GET /{locale}/api/collections/{collection_id}/cps

以下示例请求特定 collection 的商品：

curl

GET /{locale}/api/collections/{collection_id}/cps?page=0&limit=8

请求示例

Example request using Fetch

fetch(window.SHOPLAZZA.routes.root + '/api/collections/8bc2047d-bf57-4c91-b207-e3480f79800d/cps?page=0&limit=8')
  .then((response) => response.json())
  .then((data) => {
    // do something...
  });

请求参数

pagenumber

结果的基于 0 的页码。

limitnumber

限制结果数量。

[filter.filter_scope.attribute]string

请参阅店面筛选。也接受 [filter.filter_scope.attribute.attribute_scope] 写法。

响应

数据结构

data object

响应数据主体。

products object[]

商品列表。

Array [

idstring

商品 ID。

titlestring

商品名称。

briefstring

商品的简要描述。

vendorstring

商品的供应商。

vendor_urlstring

商品供应商的链接。

has_only_default_variantboolean

商品是否只有默认款式。

requires_shippingboolean

是否需要物流配送。

taxableboolean

是否需要计税。

inventory_policystring

商品缺货时是否继续销售。

inventory_quantitynumber

库存数量。

inventory_trackingboolean

是否启用库存追踪。

publishedboolean

资源是否已发布。

handlestring

用于资源链接的 handle（URL 友好别名）。

spustring

商品的 SPU（标准产品单元）。

notestring

对象上的备注。

need_variant_imageboolean

款式是否必须单独配图。

fake_salesnumber

商品的虚拟销量。

display_fake_salesboolean

是否在前台展示虚拟销量。

independent_seoboolean

是否独立管理 SEO 设置。

created_atstring

创建时间（ISO-8601 格式）。

updated_atstring

最后更新时间（ISO-8601 格式）。

tagsstring

对象上的标签。

availableboolean

是否可购买。

price_minstring

款式中的最低价格，以店铺主货币单位表示。

price_maxstring

款式中的最高价格，以店铺主货币单位表示。

pricestring

商品价格，以店铺主货币单位表示。

compare_at_pricestring

划线价。

compare_at_price_minstring

款式中的最低划线价。

compare_at_price_maxstring

款式中的最高划线价。

urlstring

商品页的相对地址。

published_atstring

发布时间（ISO-8601 格式）。

salesnumber

销量。

image object

商品的第一张图片。

srcstring

图片的地址。

widthnumber

图片宽度（像素）。

heightnumber

图片高度（像素）。

altstring

图片的替代文本。

pathstring

图片文件在图床上的路径。

aspect_rationumber

图片宽度除以高度得到的宽高比。

meta_titlestring

页面元信息中的 SEO 标题。

meta_descriptionstring

页面元信息中的 SEO 描述。

meta_keywordstring

页面元信息中的 SEO 关键词。

options object[]

商品的属性，例如颜色、尺码。

Array [

idstring

商品属性的 ID。

namestring

商品属性名称，例如 Color。

positionnumber

属性的排序位置。

valuesstring[]

商品属性的可选值列表。

]

variants object[]

商品的款式列表。

Array [

idstring

款式 ID。

titlestring

款式标题，由各属性取值用 - 连接而成。

weight_unitstring

重量单位，例如 kg。

inventory_quantitynumber

库存数量。

skustring

款式的 SKU，用于库存管理。

barcodestring

款式的条形码。

positionnumber

在列表中的排序位置。

option1string

该款式在第一个商品属性上的取值。

option2string

该款式在第二个商品属性上的取值。

option3string

该款式在第三个商品属性上的取值。

notestring

对象上的备注。

image object

款式关联的图片。

srcstring

图片的地址。

widthnumber

图片宽度（像素）。

heightnumber

图片高度（像素）。

altstring

图片的替代文本。

pathstring

图片文件在图床上的路径。

aspect_rationumber

图片宽度除以高度得到的宽高比。

weightstring

款式的重量。

compare_at_pricestring

划线价。

pricestring

款式价格，以店铺主货币单位表示。

availableboolean

是否可购买。

available_quantitynumber

仍可购买的数量。

options object[]

该款式在各商品属性上的取值。

Array [

namestring

商品属性名称，例如 Color。

valuestring

该商品属性被选中的取值。

]

urlstring

选中该款式的商品页相对地址。

off_rationumber

当前适用的折扣比率。

flashsale_infoundefined[]

商品的闪购活动信息。

salesnumber

销量。

wholesale_price object[]

批发价梯度列表。

Array [

pricestring

该批发价梯度的单价。

min_quantitynumber

该批发价梯度要求的最小数量。

]

retail_pricestring

以店铺主货币单位表示的零售价。

]

variants_countnumber

images object[]

商品图片列表。

Array [

srcstring

图片的地址。

widthnumber

图片宽度（像素）。

heightnumber

图片高度（像素）。

altstring

图片的替代文本。

pathstring

图片文件在图床上的路径。

aspect_rationumber

图片宽度除以高度得到的宽高比。

]

flashsale_infoundefined[]

商品的闪购活动信息。

off_rationumber

当前适用的折扣比率。

price_variesboolean

商品的各款式价格是否不同。

ifbstring

cfbstring

sspstring

scmstring

mixed_wholesaleboolean

是否支持混批。

retail_pricestring

以店铺主货币单位表示的零售价。

retail_price_minstring

款式中的最低零售价。

retail_price_maxstring

款式中的最高零售价。

min_price_variant object

价格最低的款式。

idstring

款式 ID。

titlestring

款式标题，由各属性取值用 - 连接而成。

weight_unitstring

重量单位，例如 kg。

inventory_quantitynumber

库存数量。

skustring

款式的 SKU，用于库存管理。

barcodestring

款式的条形码。

positionnumber

在列表中的排序位置。

option1string

该款式在第一个商品属性上的取值。

option2string

该款式在第二个商品属性上的取值。

option3string

该款式在第三个商品属性上的取值。

notestring

对象上的备注。

imagestring可空

款式关联的图片。

weightstring

款式的重量。

compare_at_pricestring

划线价。

pricestring

款式价格，以店铺主货币单位表示。

availableboolean

是否可购买。

available_quantitynumber

仍可购买的数量。

options object[]

该款式在各商品属性上的取值。

Array [

namestring

商品属性名称，例如 Color。

valuestring

该商品属性被选中的取值。

]

urlstring

选中该款式的商品页相对地址。

off_rationumber

当前适用的折扣比率。

flashsale_infoundefined[]

商品的闪购活动信息。

salesnumber

销量。

wholesale_price object[]

批发价梯度列表。

Array [

pricestring

该批发价梯度的单价。

min_quantitynumber

该批发价梯度要求的最小数量。

]

retail_pricestring

以店铺主货币单位表示的零售价。

product_typestring

商品类型。

descriptionstring

商品描述。

comment_avg_starnumber

商品评价的平均星级。

comment_countnumber

商品的顾客评价数量。

]

has_morenumber

是否还有更多记录。

pagenumber

当前页码。

limitnumber

每页最多返回的记录数。

products_countnumber

匹配到的商品总数。

countnumber

返回的商品数量。

comment_enabledboolean

是否开启了顾客评价。

msgstring

响应返回的结果说明。

statenumber

请求结果标识，success 或 0 表示请求成功。

示例

json

{
  "data": {
    "products": [
      {
        "id": "b3b656ae-504f-4f01-a054-879a610925e3",
        "title": "Sample product",
        "brief": "Sample product",
        "vendor": "",
        "vendor_url": "",
        "has_only_default_variant": false,
        "requires_shipping": true,
        "taxable": false,
        "inventory_policy": "deny",
        "inventory_quantity": 217,
        "inventory_tracking": true,
        "published": true,
        "handle": "Sample product",
        "spu": "1111",
        "note": "",
        "need_variant_image": false,
        "fake_sales": 0,
        "display_fake_sales": false,
        "independent_seo": false,
        "created_at": "2026-06-08T08:12:08Z",
        "updated_at": "2026-08-10T06:53:57Z",
        "tags": "",
        "available": true,
        "price_min": "10",
        "price_max": "90",
        "price": "10",
        "compare_at_price": "20.00",
        "compare_at_price_min": "0.00",
        "compare_at_price_max": "20.00",
        "url": "/products/Sample product",
        "published_at": "2026-07-30T02:28:23Z",
        "sales": 0,
        "image": {
          "src": "//img.staticdj.com/50fa9b8c054f4d11b0d765de5f35dd4e.png",
          "width": 1254,
          "height": 1254,
          "alt": "",
          "path": "50fa9b8c054f4d11b0d765de5f35dd4e.png",
          "aspect_ratio": 1
        },
        "meta_title": "",
        "meta_description": "",
        "meta_keyword": "",
        "options": [
          {
            "id": "5d6c5366-5c4b-4d3b-8ecd-a83d6d5b1abf",
            "name": "Color",
            "position": 1,
            "values": [
              "Black",
              "Red",
              "White"
            ]
          },
          {
            "id": "af2cadff-8ef3-4b10-a9ec-fd92a30cb18c",
            "name": "Size",
            "position": 2,
            "values": [
              "S",
              "M",
              "L"
            ]
          }
        ],
        "variants": [
          {
            "id": "0699bc80-19ae-41bb-87c4-dbcbe5ed90a0",
            "title": "Black-S",
            "weight_unit": "kg",
            "inventory_quantity": 48,
            "sku": "1111-BLACK-S-A001001",
            "barcode": "",
            "position": 1,
            "option1": "Black",
            "option2": "S",
            "option3": "",
            "note": "",
            "image": {
              "src": "",
              "width": 0,
              "height": 0,
              "alt": "",
              "path": "",
              "aspect_ratio": 0
            },
            "weight": "0",
            "compare_at_price": "20",
            "price": "10",
            "available": true,
            "available_quantity": 48,
            "options": [
              {
                "name": "Color",
                "value": "Black"
              },
              {
                "name": "Size",
                "value": "S"
              }
            ],
            "url": "/products/Sample product?variant=0699bc80-19ae-41bb-87c4-dbcbe5ed90a0",
            "off_ratio": 50,
            "flashsale_info": [],
            "sales": 0,
            "wholesale_price": [
              {
                "price": "10",
                "min_quantity": 1
              }
            ],
            "retail_price": "20"
          },
          {
            "id": "e48af6fb-dbec-4efa-9db2-94ad8f8853e4",
            "title": "Black-M",
            "weight_unit": "kg",
            "inventory_quantity": 7,
            "sku": "1111-Black-M-A001002",
            "barcode": "",
            "position": 2,
            "option1": "Black",
            "option2": "M",
            "option3": "",
            "note": "",
            "image": {
              "src": "",
              "width": 0,
              "height": 0,
              "alt": "",
              "path": "",
              "aspect_ratio": 0
            },
            "weight": "0",
            "compare_at_price": "0",
            "price": "20",
            "available": true,
            "available_quantity": 7,
            "options": [
              {
                "name": "Color",
                "value": "Black"
              },
              {
                "name": "Size",
                "value": "M"
              }
            ],
            "url": "/products/Sample product?variant=e48af6fb-dbec-4efa-9db2-94ad8f8853e4",
            "off_ratio": 0,
            "flashsale_info": [],
            "sales": 0,
            "wholesale_price": [
              {
                "price": "20",
                "min_quantity": 1
              }
            ],
            "retail_price": "0"
          },
          {
            "id": "f9a60813-bbec-49db-88d0-3d851a42d696",
            "title": "White-L",
            "weight_unit": "kg",
            "inventory_quantity": 44,
            "sku": "1111-White-L-A001009",
            "barcode": "",
            "position": 9,
            "option1": "White",
            "option2": "L",
            "option3": "",
            "note": "",
            "image": {
              "src": "",
              "width": 0,
              "height": 0,
              "alt": "",
              "path": "",
              "aspect_ratio": 0
            },
            "weight": "0",
            "compare_at_price": "0",
            "price": "90",
            "available": true,
            "available_quantity": 44,
            "options": [
              {
                "name": "Color",
                "value": "White"
              },
              {
                "name": "Size",
                "value": "L"
              }
            ],
            "url": "/products/Sample product?variant=f9a60813-bbec-49db-88d0-3d851a42d696",
            "off_ratio": 0,
            "flashsale_info": [],
            "sales": 0,
            "wholesale_price": [
              {
                "price": "90",
                "min_quantity": 1
              }
            ],
            "retail_price": "0"
          }
        ],
        "variants_count": 9,
        "images": [
          {
            "src": "//img.staticdj.com/50fa9b8c054f4d11b0d765de5f35dd4e.png",
            "width": 1254,
            "height": 1254,
            "alt": "",
            "path": "50fa9b8c054f4d11b0d765de5f35dd4e.png",
            "aspect_ratio": 1
          }
        ],
        "flashsale_info": [],
        "off_ratio": 50,
        "price_varies": true,
        "ifb": "",
        "cfb": "",
        "ssp": "",
        "scm": "",
        "mixed_wholesale": false,
        "retail_price": "20.00",
        "retail_price_min": "0.00",
        "retail_price_max": "20.00",
        "min_price_variant": {
          "id": "0699bc80-19ae-41bb-87c4-dbcbe5ed90a0",
          "title": "Black-S",
          "weight_unit": "kg",
          "inventory_quantity": 48,
          "sku": "1111-BLACK-S-A001001",
          "barcode": "",
          "position": 1,
          "option1": "Black",
          "option2": "S",
          "option3": "",
          "note": "",
          "image": null,
          "weight": "0",
          "compare_at_price": "20",
          "price": "10",
          "available": true,
          "available_quantity": 48,
          "options": [
            {
              "name": "Color",
              "value": "Black"
            },
            {
              "name": "Size",
              "value": "S"
            }
          ],
          "url": "/products/Sample product?variant=0699bc80-19ae-41bb-87c4-dbcbe5ed90a0",
          "off_ratio": 50,
          "flashsale_info": [],
          "sales": 0,
          "wholesale_price": [
            {
              "price": "10",
              "min_quantity": 1
            }
          ],
          "retail_price": "20"
        },
        "product_type": "",
        "description": "",
        "comment_avg_star": 0,
        "comment_count": 0
      },
      {
        "id": "79f46343-605c-4100-a9d5-d8a11dae3fef",
        "title": "Cozy Knit Tee",
        "brief": "",
        "vendor": "",
        "vendor_url": "",
        "has_only_default_variant": true,
        "requires_shipping": true,
        "taxable": false,
        "inventory_policy": "deny",
        "inventory_quantity": 109,
        "inventory_tracking": true,
        "published": true,
        "handle": "cozy-knit-tee",
        "spu": "",
        "note": "",
        "need_variant_image": false,
        "fake_sales": 0,
        "display_fake_sales": false,
        "independent_seo": false,
        "created_at": "2026-06-24T06:17:25Z",
        "updated_at": "2026-08-04T06:58:45Z",
        "tags": "",
        "available": true,
        "price_min": "105",
        "price_max": "105",
        "price": "105",
        "compare_at_price": "0.00",
        "compare_at_price_min": "0.00",
        "compare_at_price_max": "0.00",
        "url": "/products/cozy-knit-tee",
        "published_at": "2026-07-30T02:17:25Z",
        "sales": 0,
        "image": {
          "src": "//img.staticdj.com/66dde64782015ee2e4f31a1e08781d92.svg",
          "width": 1,
          "height": 1,
          "alt": "",
          "path": "66dde64782015ee2e4f31a1e08781d92.svg",
          "aspect_ratio": 1
        },
        "meta_title": "",
        "meta_description": "",
        "meta_keyword": "",
        "options": [],
        "variants": [
          {
            "id": "e660a2bc-c8ec-44ef-a3ab-028d317eedd9",
            "title": "",
            "weight_unit": "kg",
            "inventory_quantity": 109,
            "sku": "",
            "barcode": "",
            "position": 1,
            "option1": "",
            "option2": "",
            "option3": "",
            "note": "",
            "image": {
              "src": "",
              "width": 0,
              "height": 0,
              "alt": "",
              "path": "",
              "aspect_ratio": 0
            },
            "weight": "0",
            "compare_at_price": "0",
            "price": "105",
            "available": true,
            "available_quantity": 109,
            "options": [],
            "url": "/products/cozy-knit-tee?variant=e660a2bc-c8ec-44ef-a3ab-028d317eedd9",
            "off_ratio": 0,
            "flashsale_info": [],
            "sales": 0,
            "wholesale_price": [
              {
                "price": "105",
                "min_quantity": 1
              }
            ],
            "retail_price": "0"
          }
        ],
        "variants_count": 1,
        "images": [
          {
            "src": "//img.staticdj.com/66dde64782015ee2e4f31a1e08781d92.svg",
            "width": 1,
            "height": 1,
            "alt": "",
            "path": "66dde64782015ee2e4f31a1e08781d92.svg",
            "aspect_ratio": 1
          }
        ],
        "flashsale_info": [],
        "off_ratio": 0,
        "price_varies": false,
        "ifb": "",
        "cfb": "",
        "ssp": "",
        "scm": "",
        "mixed_wholesale": false,
        "retail_price": "0.00",
        "retail_price_min": "0.00",
        "retail_price_max": "0.00",
        "min_price_variant": {
          "id": "e660a2bc-c8ec-44ef-a3ab-028d317eedd9",
          "title": "",
          "weight_unit": "kg",
          "inventory_quantity": 109,
          "sku": "",
          "barcode": "",
          "position": 1,
          "option1": "",
          "option2": "",
          "option3": "",
          "note": "",
          "image": null,
          "weight": "0",
          "compare_at_price": "0",
          "price": "105",
          "available": true,
          "available_quantity": 109,
          "options": [],
          "url": "/products/cozy-knit-tee?variant=e660a2bc-c8ec-44ef-a3ab-028d317eedd9",
          "off_ratio": 0,
          "flashsale_info": [],
          "sales": 0,
          "wholesale_price": [
            {
              "price": "105",
              "min_quantity": 1
            }
          ],
          "retail_price": "0"
        },
        "product_type": "",
        "description": "",
        "comment_avg_star": 0,
        "comment_count": 0
      },
      {
        "id": "14a309ec-b966-4cf9-a9bb-33baa821fdbc",
        "title": "sample-product",
        "brief": "",
        "vendor": "",
        "vendor_url": "",
        "has_only_default_variant": false,
        "requires_shipping": true,
        "taxable": false,
        "inventory_policy": "",
        "inventory_quantity": 0,
        "inventory_tracking": false,
        "published": true,
        "handle": "sample-product",
        "spu": "",
        "note": "",
        "need_variant_image": false,
        "fake_sales": 0,
        "display_fake_sales": false,
        "independent_seo": false,
        "created_at": "2026-08-10T07:28:24Z",
        "updated_at": "2026-08-25T07:04:00Z",
        "tags": "",
        "available": true,
        "price_min": "1",
        "price_max": "1",
        "price": "1",
        "compare_at_price": "1.00",
        "compare_at_price_min": "1.00",
        "compare_at_price_max": "1.00",
        "url": "/products/sample-product",
        "published_at": "2026-08-10T07:28:24Z",
        "sales": 0,
        "image": {
          "src": "//img.staticdj.com/free/e6e8dc980211cbef103e16371d6e0e61.jpeg",
          "width": 3000,
          "height": 1500,
          "alt": "",
          "path": "free/e6e8dc980211cbef103e16371d6e0e61.jpeg",
          "aspect_ratio": 2
        },
        "meta_title": "",
        "meta_description": "",
        "meta_keyword": "",
        "options": [
          {
            "id": "32da111a-8237-48a7-9779-6bfa6b77f1e7",
            "name": "Size",
            "position": 1,
            "values": [
              "01",
              "02",
              "16"
            ]
          }
        ],
        "variants": [
          {
            "id": "fff360dd-6457-466a-98b3-16878bacef5b",
            "title": "01",
            "weight_unit": "kg",
            "inventory_quantity": 0,
            "sku": "",
            "barcode": "",
            "position": 1,
            "option1": "01",
            "option2": "",
            "option3": "",
            "note": "",
            "image": {
              "src": "",
              "width": 0,
              "height": 0,
              "alt": "",
              "path": "",
              "aspect_ratio": 0
            },
            "weight": "0",
            "compare_at_price": "1",
            "price": "1",
            "available": true,
            "available_quantity": 999999999,
            "options": [
              {
                "name": "Size",
                "value": "01"
              }
            ],
            "url": "/products/sample-product?variant=fff360dd-6457-466a-98b3-16878bacef5b",
            "off_ratio": 0,
            "flashsale_info": [],
            "sales": 0,
            "wholesale_price": [
              {
                "price": "1",
                "min_quantity": 1
              }
            ],
            "retail_price": "1"
          },
          {
            "id": "9063e68e-0f3a-4453-82cd-115727cce51e",
            "title": "02",
            "weight_unit": "kg",
            "inventory_quantity": 0,
            "sku": "",
            "barcode": "",
            "position": 2,
            "option1": "02",
            "option2": "",
            "option3": "",
            "note": "",
            "image": {
              "src": "",
              "width": 0,
              "height": 0,
              "alt": "",
              "path": "",
              "aspect_ratio": 0
            },
            "weight": "0",
            "compare_at_price": "1",
            "price": "1",
            "available": true,
            "available_quantity": 999999999,
            "options": [
              {
                "name": "Size",
                "value": "02"
              }
            ],
            "url": "/products/sample-product?variant=9063e68e-0f3a-4453-82cd-115727cce51e",
            "off_ratio": 0,
            "flashsale_info": [],
            "sales": 0,
            "wholesale_price": [
              {
                "price": "1",
                "min_quantity": 1
              }
            ],
            "retail_price": "1"
          },
          {
            "id": "7d4f540d-31b5-4a59-a406-eb3a981cdee5",
            "title": "16",
            "weight_unit": "kg",
            "inventory_quantity": 0,
            "sku": "",
            "barcode": "",
            "position": 16,
            "option1": "16",
            "option2": "",
            "option3": "",
            "note": "",
            "image": {
              "src": "",
              "width": 0,
              "height": 0,
              "alt": "",
              "path": "",
              "aspect_ratio": 0
            },
            "weight": "0",
            "compare_at_price": "1",
            "price": "1",
            "available": true,
            "available_quantity": 999999999,
            "options": [
              {
                "name": "Size",
                "value": "16"
              }
            ],
            "url": "/products/sample-product?variant=7d4f540d-31b5-4a59-a406-eb3a981cdee5",
            "off_ratio": 0,
            "flashsale_info": [],
            "sales": 0,
            "wholesale_price": [
              {
                "price": "1",
                "min_quantity": 1
              }
            ],
            "retail_price": "1"
          }
        ],
        "variants_count": 16,
        "images": [
          {
            "src": "//img.staticdj.com/free/e6e8dc980211cbef103e16371d6e0e61.jpeg",
            "width": 3000,
            "height": 1500,
            "alt": "",
            "path": "free/e6e8dc980211cbef103e16371d6e0e61.jpeg",
            "aspect_ratio": 2
          },
          {
            "src": "//img.staticdj.com/free/b7addf0790dc3eee7b65c693ba2140df.jpg",
            "width": 2616,
            "height": 1743,
            "alt": "",
            "path": "free/b7addf0790dc3eee7b65c693ba2140df.jpg",
            "aspect_ratio": 1.5008605851979346
          }
        ],
        "flashsale_info": [],
        "off_ratio": 0,
        "price_varies": false,
        "ifb": "",
        "cfb": "",
        "ssp": "",
        "scm": "",
        "mixed_wholesale": false,
        "retail_price": "1.00",
        "retail_price_min": "1.00",
        "retail_price_max": "1.00",
        "min_price_variant": {
          "id": "fff360dd-6457-466a-98b3-16878bacef5b",
          "title": "01",
          "weight_unit": "kg",
          "inventory_quantity": 0,
          "sku": "",
          "barcode": "",
          "position": 1,
          "option1": "01",
          "option2": "",
          "option3": "",
          "note": "",
          "image": null,
          "weight": "0",
          "compare_at_price": "1",
          "price": "1",
          "available": true,
          "available_quantity": 999999999,
          "options": [
            {
              "name": "Size",
              "value": "01"
            }
          ],
          "url": "/products/sample-product?variant=fff360dd-6457-466a-98b3-16878bacef5b",
          "off_ratio": 0,
          "flashsale_info": [],
          "sales": 0,
          "wholesale_price": [
            {
              "price": "1",
              "min_quantity": 1
            }
          ],
          "retail_price": "1"
        },
        "product_type": "",
        "description": "",
        "comment_avg_star": 0,
        "comment_count": 0
      }
    ],
    "has_more": 0,
    "page": 1,
    "limit": 8,
    "products_count": 3,
    "count": 3,
    "comment_enabled": false
  },
  "msg": "请求成功",
  "state": 0
}

获取专辑的筛选项

GET /{locale}/api/collections/{collection_id}/filters

请求示例

以下示例请求特定 collection 的 filters：

Example request using Fetch

fetch(window.SHOPLAZZA.routes.root + '/api/collections/8bc2047d-bf57-4c91-b207-e3480f79800d/filters')
  .then((response) => response.json())
  .then((data) => {
    // do something...
  });

请求参数

collection_idstring

专辑 ID。

响应

数据结构

data object[]
响应数据主体。
Array [
labelstring
筛选项的名称，例如 price、vendor。
param_namestring
该筛选项使用的 URL 参数。
typestring
筛选项类型，例如 list、price_range。
range_minnumber
price_range 类型筛选项的最小可选值。
range_maxnumber
price_range 类型筛选项的最大可选值。
values object[]
筛选项的可选值列表。
Array [
param_namestring
该筛选项使用的 URL 参数。
labelstring
展示给顾客的筛选值标签。
valuestring
筛选值。
activeboolean
该筛选值当前是否已应用。
countnumber
符合该筛选值的商品数量。
]
active_valuesstring可空
当前已应用的筛选值。
inactive_values object[]
当前未应用的筛选值。
Array [
param_namestring
该筛选项使用的 URL 参数。
labelstring
展示给顾客的筛选值标签。
valuestring
筛选值。
activeboolean
该筛选值当前是否已应用。
countnumber
符合该筛选值的商品数量。
]
max_valuestring可空
price_range 类型筛选项的上界。
min_valuestring可空
price_range 类型筛选项的下界。
]
msgstring

响应返回的结果说明。

statenumber

请求结果标识，success 或 0 表示请求成功。

示例

json

{
  "data": [
    {
      "label": "availability",
      "param_name": "filter.v.availability",
      "type": "list",
      "range_min": 0,
      "range_max": 0,
      "values": [
        {
          "param_name": "filter.v.availability",
          "label": "1",
          "value": "1",
          "active": false,
          "count": 3
        },
        {
          "param_name": "filter.v.availability",
          "label": "0",
          "value": "0",
          "active": false,
          "count": 0
        }
      ],
      "active_values": null,
      "inactive_values": [
        {
          "param_name": "filter.v.availability",
          "label": "1",
          "value": "1",
          "active": false,
          "count": 3
        },
        {
          "param_name": "filter.v.availability",
          "label": "0",
          "value": "0",
          "active": false,
          "count": 0
        }
      ],
      "max_value": null,
      "min_value": null
    },
    {
      "label": "price",
      "param_name": "filter.v.price",
      "type": "price_range",
      "range_min": 1,
      "range_max": 105,
      "values": null,
      "active_values": null,
      "inactive_values": null,
      "max_value": {
        "param_name": "filter.v.price.lte",
        "label": "To",
        "value": "",
        "active": true,
        "count": 0
      },
      "min_value": {
        "param_name": "filter.v.price.gte",
        "label": "From",
        "value": "",
        "active": true,
        "count": 0
      }
    },
    {
      "label": "vendor",
      "param_name": "filter.p.vendor",
      "type": "list",
      "range_min": 0,
      "range_max": 0,
      "values": null,
      "active_values": null,
      "inactive_values": null,
      "max_value": null,
      "min_value": null
    }
  ],
  "msg": "请求成功",
  "state": 0
}