# 商品

> 读取商品数据的 Ajax API 接口：按商品 id 获取商品 JSON、获取最近浏览商品列表，以及获取商品的周期购计划。

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

所有 Ajax API 请求应使用[多语言 URL](/zh-CN/docs/theme/references/ajax-api/#locale-aware-urls)，以便为访客提供一致的体验。

## 查询商品详情

```text
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_id` string

  商品 ID。

### 响应

**数据结构 | 示例**

- `data` object

  响应数据主体。

  - `product` object

    商品详情。

    - `id` string

      商品 ID。
    - `title` string

      商品名称。
    - `brief` string

      商品的简要描述。
    - `vendor` string

      商品的供应商。
    - `vendor_url` string

      商品供应商的链接。
    - `has_only_default_variant` boolean

      商品是否只有默认款式。
    - `requires_shipping` boolean

      是否需要物流配送。
    - `taxable` boolean

      是否需要计税。
    - `inventory_policy` string

      商品缺货时是否继续销售。
    - `inventory_quantity` number

      库存数量。
    - `inventory_tracking` boolean

      是否启用库存追踪。
    - `published` boolean

      资源是否已发布。
    - `handle` string

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

      商品的 SPU（标准产品单元）。
    - `note` string

      对象上的备注。
    - `need_variant_image` boolean

      款式是否必须单独配图。
    - `fake_sales` number

      商品的虚拟销量。
    - `display_fake_sales` boolean

      是否在前台展示虚拟销量。
    - `independent_seo` boolean

      是否独立管理 SEO 设置。
    - `created_at` string

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

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

      对象上的标签。
    - `available` boolean

      是否可购买。
    - `price_min` string

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

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

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

      划线价。
    - `compare_at_price_min` string

      款式中的最低划线价。
    - `compare_at_price_max` string

      款式中的最高划线价。
    - `url` string

      商品页的相对地址。
    - `published_at` string

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

      销量。
    - `image` object

      商品的第一张图片。

      - `src` string

        图片的地址。
      - `width` number

        图片宽度（像素）。
      - `height` number

        图片高度（像素）。
      - `alt` string

        图片的替代文本。
      - `path` string

        图片文件在图床上的路径。
      - `aspect_ratio` number

        图片宽度除以高度得到的宽高比。
    - `meta_title` string

      页面元信息中的 SEO 标题。
    - `meta_description` string

      页面元信息中的 SEO 描述。
    - `meta_keyword` string

      页面元信息中的 SEO 关键词。
    - `options` object[]

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

      *   Array [

      - `id` string

        商品属性的 ID。
      - `name` string

        商品属性名称，例如 `Color`。
      - `position` number

        属性的排序位置。
      - `values` string[]

        商品属性的可选值列表。
      *   ]
    - `variants` object[]

      商品的款式列表。

      *   Array [

      - `id` string

        款式 ID。
      - `title` string

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

        重量单位，例如 `kg`。
      - `inventory_quantity` number

        库存数量。
      - `sku` string

        款式的 SKU，用于库存管理。
      - `barcode` string

        款式的条形码。
      - `position` number

        在列表中的排序位置。
      - `option1` string

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

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

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

        对象上的备注。
      - `image` object

        款式关联的图片。

        - `src` string

          图片的地址。
        - `width` number

          图片宽度（像素）。
        - `height` number

          图片高度（像素）。
        - `alt` string

          图片的替代文本。
        - `path` string

          图片文件在图床上的路径。
        - `aspect_ratio` number

          图片宽度除以高度得到的宽高比。
      - `weight` string

        款式的重量。
      - `compare_at_price` string

        划线价。
      - `price` string

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

        是否可购买。
      - `available_quantity` number

        仍可购买的数量。
      - `options` object[]

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

        *   Array [

        - `name` string

          商品属性名称，例如 `Color`。
        - `value` string

          该商品属性被选中的取值。
        *   ]
      - `url` string

        选中该款式的商品页相对地址。
      - `off_ratio` number

        当前适用的折扣比率。
      - `flashsale_info` undefined[]

        商品的闪购活动信息。
      - `sales` number

        销量。
      - `wholesale_price` object[]

        批发价梯度列表。

        *   Array [

        - `price` string

          该批发价梯度的单价。
        - `min_quantity` number

          该批发价梯度要求的最小数量。
        *   ]
      - `retail_price` string

        以店铺主货币单位表示的零售价。
      *   ]
    - `variants_count` number
    - `images` object[]

      商品图片列表。

      *   Array [

      - `src` string

        图片的地址。
      - `width` number

        图片宽度（像素）。
      - `height` number

        图片高度（像素）。
      - `alt` string

        图片的替代文本。
      - `path` string

        图片文件在图床上的路径。
      - `aspect_ratio` number

        图片宽度除以高度得到的宽高比。
      *   ]
    - `flashsale_info` undefined[]

      商品的闪购活动信息。
    - `off_ratio` number

      当前适用的折扣比率。
    - `price_varies` boolean

      商品的各款式价格是否不同。
    - `ifb` string
    - `cfb` string
    - `ssp` string
    - `scm` string
    - `mixed_wholesale` boolean

      是否支持混批。
    - `retail_price` string

      以店铺主货币单位表示的零售价。
    - `retail_price_min` string

      款式中的最低零售价。
    - `retail_price_max` string

      款式中的最高零售价。
    - `min_price_variant` object

      价格最低的款式。

      - `id` string

        款式 ID。
      - `title` string

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

        重量单位，例如 `kg`。
      - `inventory_quantity` number

        库存数量。
      - `sku` string

        款式的 SKU，用于库存管理。
      - `barcode` string

        款式的条形码。
      - `position` number

        在列表中的排序位置。
      - `option1` string

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

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

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

        对象上的备注。
      - `image` string

        款式关联的图片。
      - `weight` string

        款式的重量。
      - `compare_at_price` string

        划线价。
      - `price` string

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

        是否可购买。
      - `available_quantity` number

        仍可购买的数量。
      - `options` object[]

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

        *   Array [

        - `name` string

          商品属性名称，例如 `Color`。
        - `value` string

          该商品属性被选中的取值。
        *   ]
      - `url` string

        选中该款式的商品页相对地址。
      - `off_ratio` number

        当前适用的折扣比率。
      - `flashsale_info` undefined[]

        商品的闪购活动信息。
      - `sales` number

        销量。
      - `wholesale_price` object[]

        批发价梯度列表。

        *   Array [

        - `price` string

          该批发价梯度的单价。
        - `min_quantity` number

          该批发价梯度要求的最小数量。
        *   ]
      - `retail_price` string

        以店铺主货币单位表示的零售价。
    - `product_type` string

      商品类型。
    - `description` string

      商品描述。
    - `comment_avg_star` number

      商品评价的平均星级。
    - `comment_count` number

      商品的顾客评价数量。
- `msg` string

  响应返回的结果说明。
- `state` number

  请求结果标识，`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
}
```

## 获取最近浏览商品列表

```text
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...
  });

```

### 请求参数

- `page` string

  基于 1 的页码。
- `limit` string

  每页的商品数量。

### 响应

**数据结构 | 示例**

- `data` object

  响应数据主体。

  - `comment_enabled` boolean

    是否开启了顾客评价。
  - `has_more` number

    是否还有更多记录。
  - `limit` number

    每页最多返回的记录数。
  - `list` object[]

    商品列表。

    *   Array [

    - `id` string

      商品 ID。
    - `title` string

      商品名称。
    - `brief` string

      商品的简要描述。
    - `vendor` string

      商品的供应商。
    - `vendor_url` string

      商品供应商的链接。
    - `has_only_default_variant` boolean

      商品是否只有默认款式。
    - `requires_shipping` boolean

      是否需要物流配送。
    - `taxable` boolean

      是否需要计税。
    - `inventory_policy` string

      商品缺货时是否继续销售。
    - `inventory_quantity` number

      库存数量。
    - `inventory_tracking` boolean

      是否启用库存追踪。
    - `published` boolean

      资源是否已发布。
    - `handle` string

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

      商品的 SPU（标准产品单元）。
    - `note` string

      对象上的备注。
    - `need_variant_image` boolean

      款式是否必须单独配图。
    - `fake_sales` number

      商品的虚拟销量。
    - `display_fake_sales` boolean

      是否在前台展示虚拟销量。
    - `independent_seo` boolean

      是否独立管理 SEO 设置。
    - `created_at` string

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

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

      对象上的标签。
    - `available` boolean

      是否可购买。
    - `price_min` string

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

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

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

      划线价。
    - `compare_at_price_min` string

      款式中的最低划线价。
    - `compare_at_price_max` string

      款式中的最高划线价。
    - `url` string

      商品页的相对地址。
    - `published_at` string

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

      销量。
    - `image` object

      商品的第一张图片。

      - `src` string

        图片的地址。
      - `width` number

        图片宽度（像素）。
      - `height` number

        图片高度（像素）。
      - `alt` string

        图片的替代文本。
      - `path` string

        图片文件在图床上的路径。
      - `aspect_ratio` number

        图片宽度除以高度得到的宽高比。
    - `meta_title` string

      页面元信息中的 SEO 标题。
    - `meta_description` string

      页面元信息中的 SEO 描述。
    - `meta_keyword` string

      页面元信息中的 SEO 关键词。
    - `options` object[]

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

      *   Array [

      - `id` string

        商品属性的 ID。
      - `name` string

        商品属性名称，例如 `Color`。
      - `position` number

        属性的排序位置。
      - `values` string[]

        商品属性的可选值列表。
      *   ]
    - `variants` object[]

      商品的款式列表。

      *   Array [

      - `id` string

        款式 ID。
      - `title` string

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

        重量单位，例如 `kg`。
      - `inventory_quantity` number

        库存数量。
      - `sku` string

        款式的 SKU，用于库存管理。
      - `barcode` string

        款式的条形码。
      - `position` number

        在列表中的排序位置。
      - `option1` string

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

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

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

        对象上的备注。
      - `image` object

        款式关联的图片。

        - `src` string

          图片的地址。
        - `width` number

          图片宽度（像素）。
        - `height` number

          图片高度（像素）。
        - `alt` string

          图片的替代文本。
        - `path` string

          图片文件在图床上的路径。
        - `aspect_ratio` number

          图片宽度除以高度得到的宽高比。
      - `weight` string

        款式的重量。
      - `compare_at_price` string

        划线价。
      - `price` string

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

        是否可购买。
      - `available_quantity` number

        仍可购买的数量。
      - `options` object[]

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

        *   Array [

        - `name` string

          商品属性名称，例如 `Color`。
        - `value` string

          该商品属性被选中的取值。
        *   ]
      - `url` string

        选中该款式的商品页相对地址。
      - `off_ratio` number

        当前适用的折扣比率。
      - `flashsale_info` undefined[]

        商品的闪购活动信息。
      - `sales` number

        销量。
      - `wholesale_price` object[]

        批发价梯度列表。

        *   Array [

        - `price` string

          该批发价梯度的单价。
        - `min_quantity` number

          该批发价梯度要求的最小数量。
        *   ]
      - `retail_price` string

        以店铺主货币单位表示的零售价。
      *   ]
    - `variants_count` number
    - `images` object[]

      商品图片列表。

      *   Array [

      - `src` string

        图片的地址。
      - `width` number

        图片宽度（像素）。
      - `height` number

        图片高度（像素）。
      - `alt` string

        图片的替代文本。
      - `path` string

        图片文件在图床上的路径。
      - `aspect_ratio` number

        图片宽度除以高度得到的宽高比。
      *   ]
    - `flashsale_info` undefined[]

      商品的闪购活动信息。
    - `off_ratio` number

      当前适用的折扣比率。
    - `price_varies` boolean

      商品的各款式价格是否不同。
    - `ifb` string
    - `cfb` string
    - `ssp` string
    - `scm` string
    - `mixed_wholesale` boolean

      是否支持混批。
    - `retail_price` string

      以店铺主货币单位表示的零售价。
    - `retail_price_min` string

      款式中的最低零售价。
    - `retail_price_max` string

      款式中的最高零售价。
    - `min_price_variant` object

      价格最低的款式。

      - `id` string

        款式 ID。
      - `title` string

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

        重量单位，例如 `kg`。
      - `inventory_quantity` number

        库存数量。
      - `sku` string

        款式的 SKU，用于库存管理。
      - `barcode` string

        款式的条形码。
      - `position` number

        在列表中的排序位置。
      - `option1` string

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

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

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

        对象上的备注。
      - `image` string

        款式关联的图片。
      - `weight` string

        款式的重量。
      - `compare_at_price` string

        划线价。
      - `price` string

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

        是否可购买。
      - `available_quantity` number

        仍可购买的数量。
      - `options` object[]

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

        *   Array [

        - `name` string

          商品属性名称，例如 `Color`。
        - `value` string

          该商品属性被选中的取值。
        *   ]
      - `url` string

        选中该款式的商品页相对地址。
      - `off_ratio` number

        当前适用的折扣比率。
      - `flashsale_info` undefined[]

        商品的闪购活动信息。
      - `sales` number

        销量。
      - `wholesale_price` object[]

        批发价梯度列表。

        *   Array [

        - `price` string

          该批发价梯度的单价。
        - `min_quantity` number

          该批发价梯度要求的最小数量。
        *   ]
      - `retail_price` string

        以店铺主货币单位表示的零售价。
    - `product_type` string

      商品类型。
    - `description` string

      商品描述。
    - `comment_avg_star` number

      商品评价的平均星级。
    - `comment_count` number

      商品的顾客评价数量。
    *   ]
  - `page` number

    当前页码。
  - `sort` object

    - `` object
  - `total` number

    匹配到的商品总数。
- `msg` string

  响应返回的结果说明。
- `state` number

  请求结果标识，`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
}
```

## 获取商品的周期购计划

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

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

### 请求示例

**请求示例**

```javascript
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_id` string

  商品的 id。

### 响应

**数据结构 | 示例**

- `block_style` string
- `store_ini_payment_subscription` boolean
- `sku` object

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

  - `` object
- `spu` object

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

  - `` object

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