购物车添加商品​

购物车 API 用于客户在会话期间产生的购物车交互，当需要向购物车中的添加新的商品时可通过请求这个接口完成对应操作。

请求信息​

API路径：​

POST https://{handle}.myshopline.com/cart/add

请求header：​

参数名

参数类型

是否必填

是否数组

默认值

描述

Content-Type

String

Y

N

application/json

Accept

String

N

N

*/*

响应内容类型和状态码根据该字段传值不同而有所区别，有效枚举值包含：

  1. \*/\*：

  • 响应 content-type ：text/html; charset=utf-8

  • 状态码：302，默认重定向至购物车页面。

  1. application/json：

  • 响应 content-type ：application/json; charset=utf-8

  • 状态码：200

请求body：​

一级参数名

二级参数名

参数类型

是否必填

是否数组

示例

描述

items

Object[]

Y

Y

购物车商品列表

id

String

Y

N

36110175633573

商品唯一标识 即sku_id

quantity

Long

Y

N

2

添加的商品数目，添加后购物车中该商品数目=原数目+此次添加数目

groupId

String

N

N

0

商品组ID，添加购物车不存在的商品时候不需要填写*当添加购物车有同个商品因为不同属性组而拆行时，此时需要传入groupId来对应

properties

Object

N

Y

image.png

  1. name（必填）: 自定义属性名

  2. value: 自定义属性值

  3. type（必填）: 类型，属性枚举有text,picture,link三种类型，text:字符，展示类型为 name: value； picture: 图片，展示类型为name: 通过urls获取渲染出缩略图,缩略图点击弹窗展示，并支持下载；link: 超链，展示类型为name: value，支持点击跳转 到urls第一个

  4. show: 是否展示在前台

  5. extInfo: 扩展字段

sections

String

N

N

cart-notification-product,cart-notification-button

需要捆绑 section 渲染的 section，多个 section 使用 , 符号分割

sections_url

String

N

N

/products/dress

指定捆绑 section 渲染的页面

响应信息​

响应body：​

参数名

参数类型

是否数组

示例

描述

items

Object[]

Y

购物车商品列表

id

String

N

36110175633573

商品唯一标识 即sku_id

group_id

String

N

0

商品组ID

quantity

Integer

N

2

商品数量

properties

Long

N

image.png

  1. name: 自定义属性名

  2. value: 自定义属性值

  3. type: 类型，属性枚举有text,picture,link三种类型，text:字符，展示类型为 name: value； picture: 图片，展示类型为name: 通过urls获取渲染出缩略图,缩略图点击弹窗展示，并支持下载；link: 超链，展示类型为name: value，支持点击跳转 到urls第一个

  4. show: 是否展示在前台

  5. extInfo: 扩展字段

variant_id

String

N

36110175633573

商品 sku_id

title

String

N

test1

商品title+sku title 名称+规格

price

Double

N

200

商品 售价

original_price

Double

N

200

商品 原价 (可能为0)

discounted_price

Double

N

200

减去优惠后的价格

line_price

Double

N

200

商品行售价

original_line_price

Double

N

200

商品行原价(可能为0)

total_discount

Double

N

200

单个商品的总折扣金额

discounts

Object

Y

商品行优惠

amount

Double

N

200

优惠金额

title

String

N

满100减50

优惠名称

sku

String

N

红色XL

商品 sku_id

grams

String

N

100

商品重量 单位g

taxable

Boolean

N

true

是否收税

product_id

String

N

36110175633573

商品 spu_id

gift_card

Boolean

N

true

是否为礼品卡商品

final_price

Double

N

500

商品参与计价的金额

final_line_price

Double

N

500

商品行参与计价的金额

url

String

N

https://ddfasdfasdf

商品主站链接

featured_image

String

N

aspectRatio

Double

N

纵横比

alt

String

N

鼠标悬停提示信息

height

Integer

N

显示高度

url

String

N

图片

width

Integer

N

显示宽度

image

String

N

商品image

handle

String

N

商品handle

requires_shipping

String

N

是否需要发货

product_title

String

N

商品title

variant_title

String

N

所有规格的拼接

variant_options

String

N

所有规格枚举

options_with_values

String

N

规格

name

String

N

规格名称

value

String

N

规格值

line_level_discount_allocations

String

N

商品行优惠信息

amount

Double

N

优惠金额

discountApplication

String

N

type

Integer

N

商品行享受的活动类型。

0：满减满折、免邮,

1：限时促销,

2：捆绑组合,

3：优惠码,

4：一页商店,

5：赠品活动,

6：预售,

7：加购品,

8：礼品盒,

9：商品追售活动

title

String

N

优惠名称

description

String

N

优惠描述

value

Double

N

优惠金额

created_at

String

N

活动创建时间

value_type

String

N

折扣活动类型:

  1. percentage:折扣

  2. fix_amount 固定金额

target_type

String

N

优惠作用对象:

  1. line_item 商品

  2. shipping_line 运费

benefit_typest

Integer

N

商品行享受的优惠类型。

-1：无优惠

1：减金额

2：打折

3：免运费

4：加价品

5：任意N件优惠价

6：A+B组合优惠价

7：赠品

8：固定售价

9：最低价商品免费

11：第N件打折

12：买x送y

13：自定义

14：N件M元

status

String

N

折扣码在购物车应用状态：

  • enable：无法在当前购物车应用

  • unable：可以在当前购物车应用

error_code

String

N

当折扣码无法应用时会返回报错码

error_message

String

N

当折扣码无法应用时会返回报错文案

line_level_total_discount

Double

N

商品行优惠总金额

sections

Object

N

{ "header": "<p>header</p>" }

section 渲染结果

请求、响应示例​

场景1：正常更新购物车​

{
  "items": [
    {
      "id": "18053690554475963802050412",
      "properties": null,
      "quantity": 10,
      "title": "自定义商品100个 ",
      "price": 10,
      "discounts": [],
      "sku": "18053690554475963802050412",
      "grams": "0.0",
      "taxable": true,
      "url": "https://test001.myshopline.com/products/自定义商品100个",
      "image": "https://img.myshopline.com/image/official/e46e6189dd5641a3b179444cacdcdd2a.png",
      "handle": "自定义商品100个",
      "group_id": "0",
      "variant_id": "18053690554475963802050412",
      "original_price": 0,
      "discounted_price": 10,
      "line_price": 100,
      "original_line_price": 0,
      "total_discount": 0,
      "product_id": "16053690554473111675530412",
      "gift_card": false,
      "final_price": 10,
      "final_line_price": 100,
      "featured_image": {
        "alt": null,
        "height": null,
        "url": "https://test001.myshopline.com/products/仅仅是限时促销商品",
        "width": null,
        "aspect_ratio": null
      },
      "requires_shipping": true,
      "product_title": "自定义商品100个",
      "variant_title": "",
      "variant_options": [],
      "options_with_values": [],
      "line_level_discount_allocations": [],
      "line_level_total_discount": 0
    },
    {
      "id": "18053340946130027787140412",
      "properties": null,
      "quantity": 1,
      "title": "仅仅是限时促销商品 ",
      "price": 10,
      "discounts": [
        {
          "amount": 9,
          "title": "促销活动1"
        }
      ],
      "sku": "18053340946130027787140412",
      "grams": "0.0",
      "taxable": true,
      "url": "https://test001.myshopline.com/products/仅仅是限时促销商品",
      "image": "https://img.myshopline.com/image/official/e46e6189dd5641a3b179444cacdcdd2a.png",
      "handle": "仅仅是限时促销商品",
      "group_id": "0",
      "variant_id": "18053340946130027787140412",
      "original_price": 0,
      "discounted_price": 1,
      "line_price": 10,
      "original_line_price": 0,
      "total_discount": 9,
      "product_id": "16053340946118954823760412",
      "gift_card": false,
      "final_price": 1,
      "final_line_price": 1,
      "featured_image": {
        "alt": null,
        "height": null,
        "url": "https://img.myshopline.com/image/official/e46e6189dd5641a3b179444cacdcdd2a.png",
        "width": null,
        "aspect_ratio": null
      },
      "requires_shipping": true,
      "product_title": "仅仅是限时促销商品",
      "variant_title": "",
      "variant_options": [],
      "options_with_values": [],
      "line_level_discount_allocations": [
        {
          "amount": 9,
          "discount_application": {
            "type": 8,
            "title": "促销活动1",
            "description": null,
            "value": 9,
            "created_at": null,
            "value_type": null,
            "target_type": "line_item",
            "status": "enable",
            "error_code": null,
            "error_message": null
          }
        }
      ],
      "line_level_total_discount": 9
    }
  ],
  "sections": {}
}

场景2：购物车不存在：​

POST https://{handle}.myshopline.com/cart/add

status:404 
{
  "message": "error code",
  "description": "error description"
}

场景3：捆绑 section 渲染：​

POST https://{handle}.myshopline.com/cart/add

{
    "items": [
        {
            "id": "18053690554475963802050412",
            "properties": null,
            "quantity": 10,
            "title": "自定义商品100个 ",
            "price": 10,
            "discounts": [],
            "sku": "18053690554475963802050412",
            "grams": "0.0",
            "taxable": true,
            "url": "https://test001.myshopline.com/products/自定义商品100个",
            "image": "https://img.myshopline.com/image/official/e46e6189dd5641a3b179444cacdcdd2a.png",
            "handle": "自定义商品100个",
            "group_id": "0",
            "variant_id": "18053690554475963802050412",
            "original_price": 0,
            "discounted_price": 10,
            "line_price": 100,
            "original_line_price": 0,
            "total_discount": 0,
            "product_id": "16053690554473111675530412",
            "gift_card": false,
            "final_price": 10,
            "final_line_price": 100,
            "featured_image": {},
            "requires_shipping": true,
            "product_title": "自定义商品100个",
            "variant_title": "",
            "variant_options": [],
            "options_with_values": [],
            "line_level_discount_allocations": [],
            "line_level_total_discount": 0
        }
    ],
   "sections": {
        "cart-notification-product": "<div id=\"shopline-section-cart-notification-product\" class=\"shopline-section\"><link rel=\"dns-prefetch\" href=\"https://fonts.googleapis.com\">\n<link rel=\"preconnect\" href=\"https://fonts.googleapis.com\" crossorigin>\n<link rel=\"dns-prefetch\" href=\"https://fonts.gstatic.com\">\n<link rel=\"stylesheet\" href=\"https://fonts.googleapis.com/css?family=Montserrat:500|Poppins:300&display=swap\" media=\"all\">    <div id=\"cart-notification-product-18062607064090484554672730:6dbf69a53a854f65ab2e23e783a7dcff\" class=\"cart-item\">\n      <div class=\"cart-notification-product__image global-media-border-shadow\">\n          <img\n            src=\"https://d2n979dmt31clo.cloudfront.net/image/store/1655365532096/-_200x.jpeg?w=275&h=183\"\n            alt=\"\"\n            width=\"100\"\n            height=\"67\"\n            loading=\"lazy\"\n          />\n      </div>\n      <div class=\"cart-notification-product__details\">\n        <div class=\"cart-notification-product__name body2\">三文鱼鱼籽</div>\n\n      </div>\n    </div>\n</div>",
        "cart-notification-button": "<div id=\"shopline-section-cart-notification-button\" class=\"shopline-section\"><link rel=\"dns-prefetch\" href=\"https://fonts.googleapis.com\">\n<link rel=\"preconnect\" href=\"https://fonts.googleapis.com\" crossorigin>\n<link rel=\"dns-prefetch\" href=\"https://fonts.gstatic.com\">\n<link rel=\"stylesheet\" href=\"https://fonts.googleapis.com/css?family=Montserrat:500|Poppins:300&display=swap\" media=\"all\"><div class=\"cart-notification-button\">View cart (6)</div></div>",
        "cart-icon-bubble": "<div id=\"shopline-section-cart-icon-bubble\" class=\"shopline-section\"><link rel=\"dns-prefetch\" href=\"https://fonts.googleapis.com\">\n<link rel=\"preconnect\" href=\"https://fonts.googleapis.com\" crossorigin>\n<link rel=\"dns-prefetch\" href=\"https://fonts.gstatic.com\">\n<link rel=\"stylesheet\" href=\"https://fonts.googleapis.com/css?family=Montserrat:500|Poppins:300&display=swap\" media=\"all\"><div id=\"cart-icon-bubble-wrapper\">\n  <svg class=\"icon icon-cart\" width=\"18\" height=\"20\" viewBox=\"0 0 18 20\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\">\n<path d=\"M1.10959 19L1 6H17L16.8904 19H1.10959Z\" stroke=\"currentColor\" stroke-width=\"1.5\" stroke-linecap=\"round\" stroke-linejoin=\"round\"/>\n<path d=\"M5 6V5C5 2.79086 6.79086 1 9 1V1C11.2091 1 13 2.79086 13 5V6\" stroke=\"currentColor\" stroke-width=\"1.5\" stroke-linecap=\"round\" stroke-linejoin=\"round\"/>\n</svg>\n\n    <span class=\"header__cart-point body6\">6</span>\n</div>\n</div>",
        "cart-notification-subtotal": "<div id=\"shopline-section-cart-notification-subtotal\" class=\"shopline-section\"><link rel=\"dns-prefetch\" href=\"https://fonts.googleapis.com\">\n<link rel=\"preconnect\" href=\"https://fonts.googleapis.com\" crossorigin>\n<link rel=\"dns-prefetch\" href=\"https://fonts.gstatic.com\">\n<link rel=\"stylesheet\" href=\"https://fonts.googleapis.com/css?family=Montserrat:500|Poppins:300&display=swap\" media=\"all\"><div class=\"cart-notification-subtotal\">\n  <em class=\"body2\">Cart subtotal</em>\n  <span class=\"body1 fw-bold\">HK$0.00</span>\n</div></div>"
    }
}
这篇文章对你有帮助吗？
SHOPLINE
SHOPLINE
SHOPLINE Enterprise
条款协议
隐私
条款
开发者协议
LinkedInEmail
LinkedInEmail
© Copyright 2013-2025 SHOPLINE Limited.