商品

您可以使用 Ajax Product API 对任意商品信息发起 GET 请求。

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

查询商品详情

GET /{locale}/api/products/{product_id}

使用商品的 id 获取商品的 JSON 格式数据。

所有货币属性均以客户的展示货币返回。

请求示例

javascript

fetch(window.SHOPLAZZA.routes.root + '/api/products/588ed0ce-40af-44c7-8dea-afa18b489ef8')
  .then((response) => response.json())
  .then((data) => {
    // do something...
  });

请求参数

product_idstring

商品 ID。

响应

数据结构

data object

响应数据主体。

product object

商品详情。

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

商品的顾客评价数量。

msgstring

响应返回的结果说明。

statenumber

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

示例

json

{
  "data": {
    "product": {
      "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": "sample-product",
      "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": 0,
      "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": "default",
      "description": "",
      "comment_avg_star": 0,
      "comment_count": 0
    }
  },
  "msg": "请求成功",
  "state": 0
}

获取最近浏览商品列表

GET /{locale}/api/product/list

获取最近浏览商品列表的 JSON 格式数据。

所有货币属性均以客户的展示货币返回。

请求示例

javascript

fetch(window.SHOPLAZZA.routes.root + '/api/product/list?page=1&limit=100')
  .then((response) => response.json())
  .then((data) => {
    // do something...
  });

请求参数

pagestring

基于 1 的页码。

limitstring

每页的商品数量。

响应

数据结构

data object

响应数据主体。

comment_enabledboolean

是否开启了顾客评价。

has_morenumber

是否还有更多记录。

limitnumber

每页最多返回的记录数。

list 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

商品的顾客评价数量。

]

pagenumber

当前页码。

sort object

object

totalnumber

匹配到的商品总数。

msgstring

响应返回的结果说明。

statenumber

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

示例

json

{
  "data": {
    "comment_enabled": false,
    "has_more": 0,
    "limit": 8,
    "list": [
      {
        "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": "sample-product",
        "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": 0,
        "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": "default",
        "description": "",
        "comment_avg_star": 0,
        "comment_count": 0
      },
      {
        "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": "Sample product",
        "meta_description": "Sample product",
        "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": 0,
        "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": "default",
        "description": "",
        "comment_avg_star": 0,
        "comment_count": 0
      },
      {
        "id": "dfe46c91-5f48-4099-ba1f-0168b1632601",
        "title": "Shipping Protection",
        "brief": "",
        "vendor": "",
        "vendor_url": "",
        "has_only_default_variant": false,
        "requires_shipping": false,
        "taxable": false,
        "inventory_policy": "",
        "inventory_quantity": 0,
        "inventory_tracking": false,
        "published": true,
        "handle": "Shipping Protection",
        "spu": "",
        "note": "",
        "need_variant_image": false,
        "fake_sales": 0,
        "display_fake_sales": false,
        "independent_seo": false,
        "created_at": "2026-07-30T06:50:36Z",
        "updated_at": "2026-07-30T06:51:11Z",
        "tags": "",
        "available": true,
        "price_min": "0.5",
        "price_max": "10",
        "price": "0.5",
        "compare_at_price": "1.00",
        "compare_at_price_min": "1.00",
        "compare_at_price_max": "1.00",
        "url": "/products/Shipping Protection",
        "published_at": "2026-07-30T06:51:11Z",
        "sales": 0,
        "image": {
          "src": "//img.staticdj.com/50fa9b8c054f4d11b0d765de5f35dd4e.png",
          "width": 1254,
          "height": 1254,
          "alt": "",
          "path": "50fa9b8c054f4d11b0d765de5f35dd4e.png",
          "aspect_ratio": 1
        },
        "meta_title": "Shipping Protection",
        "meta_description": "",
        "meta_keyword": "",
        "options": [
          {
            "id": "16d1facf-bbcd-4f4e-bf95-cb71a41875b2",
            "name": "Tier",
            "position": 1,
            "values": [
              "0.5",
              "1",
              "10"
            ]
          }
        ],
        "variants": [
          {
            "id": "eb84218e-5a6f-41dc-b884-c8e13307bb50",
            "title": "0.5",
            "weight_unit": "kg",
            "inventory_quantity": 0,
            "sku": "",
            "barcode": "",
            "position": 1,
            "option1": "0.5",
            "option2": "",
            "option3": "",
            "note": "",
            "image": {
              "src": "",
              "width": 0,
              "height": 0,
              "alt": "",
              "path": "",
              "aspect_ratio": 0
            },
            "weight": "0",
            "compare_at_price": "1",
            "price": "0.5",
            "available": true,
            "available_quantity": 999999999,
            "options": [
              {
                "name": "Tier",
                "value": "0.5"
              }
            ],
            "url": "/products/Shipping Protection?variant=eb84218e-5a6f-41dc-b884-c8e13307bb50",
            "off_ratio": 50,
            "flashsale_info": [],
            "sales": 0,
            "wholesale_price": [
              {
                "price": "0.5",
                "min_quantity": 1
              }
            ],
            "retail_price": "1"
          },
          {
            "id": "a2bc248e-0cf2-46f4-b5ee-d6286e6ffef1",
            "title": "1",
            "weight_unit": "kg",
            "inventory_quantity": 0,
            "sku": "",
            "barcode": "",
            "position": 2,
            "option1": "1",
            "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": "Tier",
                "value": "1"
              }
            ],
            "url": "/products/Shipping Protection?variant=a2bc248e-0cf2-46f4-b5ee-d6286e6ffef1",
            "off_ratio": 0,
            "flashsale_info": [],
            "sales": 0,
            "wholesale_price": [
              {
                "price": "1",
                "min_quantity": 1
              }
            ],
            "retail_price": "1"
          },
          {
            "id": "66ba5a00-407d-4bd3-8334-4e60f24e0483",
            "title": "10",
            "weight_unit": "kg",
            "inventory_quantity": 0,
            "sku": "",
            "barcode": "",
            "position": 5,
            "option1": "10",
            "option2": "",
            "option3": "",
            "note": "",
            "image": {
              "src": "",
              "width": 0,
              "height": 0,
              "alt": "",
              "path": "",
              "aspect_ratio": 0
            },
            "weight": "0",
            "compare_at_price": "1",
            "price": "10",
            "available": true,
            "available_quantity": 999999999,
            "options": [
              {
                "name": "Tier",
                "value": "10"
              }
            ],
            "url": "/products/Shipping Protection?variant=66ba5a00-407d-4bd3-8334-4e60f24e0483",
            "off_ratio": 0,
            "flashsale_info": [],
            "sales": 0,
            "wholesale_price": [
              {
                "price": "10",
                "min_quantity": 1
              }
            ],
            "retail_price": "1"
          }
        ],
        "variants_count": 0,
        "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": "1.00",
        "retail_price_min": "1.00",
        "retail_price_max": "1.00",
        "min_price_variant": {
          "id": "eb84218e-5a6f-41dc-b884-c8e13307bb50",
          "title": "0.5",
          "weight_unit": "kg",
          "inventory_quantity": 0,
          "sku": "",
          "barcode": "",
          "position": 1,
          "option1": "0.5",
          "option2": "",
          "option3": "",
          "note": "",
          "image": null,
          "weight": "0",
          "compare_at_price": "1",
          "price": "0.5",
          "available": true,
          "available_quantity": 999999999,
          "options": [
            {
              "name": "Tier",
              "value": "0.5"
            }
          ],
          "url": "/products/Shipping Protection?variant=eb84218e-5a6f-41dc-b884-c8e13307bb50",
          "off_ratio": 50,
          "flashsale_info": [],
          "sales": 0,
          "wholesale_price": [
            {
              "price": "0.5",
              "min_quantity": 1
            }
          ],
          "retail_price": "1"
        },
        "product_type": "default",
        "description": "",
        "comment_avg_star": 0,
        "comment_count": 0
      }
    ],
    "page": 1,
    "sort": {},
    "total": 4
  },
  "msg": "请求成功",
  "state": 0
}

获取商品的周期购计划

GET /{locale}/api/storefront/selling_plans/product_plan_info/{product_id}

获取某个商品的周期购（订阅）计划信息，product_id 取商品的 id。

请求示例

请求示例

fetch(window.SHOPLAZZA.routes.root + '/api/storefront/selling_plans/product_plan_info/14a309ec-b966-4cf9-a9bb-33baa821fdbc')
  .then((response) => response.json())
  .then((data) => {
    // do something...
  });

请求参数

product_idstring

商品的 id。

响应

数据结构

block_stylestring
store_ini_payment_subscriptionboolean
sku object
款式的 SKU，用于库存管理。
object
spu object
商品的 SPU（标准产品单元）。
object

示例

json

{
  "block_style": "1",
  "store_ini_payment_subscription": true,
  "sku": {},
  "spu": {}
}