跳到主要内容

购物车

添加购物车商品​

将商品添加到购物车。

  • URL：/app-api/trade/cart/add
  • Method：POST
  • 需要登录：是
  • 需要鉴权：是

请求参数​

参数类型约束说明
skuIdLong必传商品 SKU 编号
countInteger必传商品数量，大于等于 1

请求示例​

{
    "skuId": 35,
    "count": 1
}

响应示例​

成功：

{
    "code": 200,
    "data": 25,
    "msg": "成功"
}

库存不足：

{
    "code": 1008006004,
    "data": null,
    "msg": "商品 SKU 库存不足"
}

响应说明​

参数类型说明
dataLong购物项编号

更新购物车商品数量​

修改购物车中商品的数量。

  • URL：/app-api/trade/cart/update-count
  • Method：POST
  • 需要登录：是
  • 需要鉴权：是

请求参数​

参数类型约束说明
idLong必传购物项编号
countInteger必传商品数量，大于等于 1

请求示例​

{
    "id": 34,
    "count": 1
}

响应示例​

{
    "code": 200,
    "data": true,
    "msg": "成功"
}

响应说明​

参数类型说明
dataBooleantrue 成功，false 失败

更新购物车商品选中状态​

批量更新购物车商品的选中状态。

  • URL：/app-api/trade/cart/update-selected
  • Method：POST
  • 需要登录：是
  • 需要鉴权：是

请求参数​

参数类型约束说明
idsList<Long>必传购物项编号集合
selectedBoolean必传是否选中，true-选中，false-取消选中

请求示例​

{
    "ids": [97, 98],
    "selected": true
}

响应示例​

{
    "code": 200,
    "data": true,
    "msg": "成功"
}

响应说明​

参数类型说明
dataBooleantrue 成功，false 失败

获取购物车列表​

获取用户的购物车列表，包含有效和无效商品。

  • URL：/app-api/trade/cart/list
  • Method：GET
  • 需要登录：是
  • 需要鉴权：是

请求参数​

无请求参数。

请求示例​

GET /app-api/trade/cart/list

响应示例​

{
    "code": 0,
    "data": {
        "validList": [
            {
                "id": 98,
                "count": 1,
                "selected": false,
                "spu": {
                    "id": 634,
                    "name": "HUAWEI Mate 60 Pro",
                    "picUrl": "https://example.com/product.jpg",
                    "categoryId": 48
                },
                "sku": {
                    "id": 16,
                    "picUrl": "https://example.com/sku.jpg",
                    "price": 699900,
                    "stock": 290,
                    "properties": [
                        {
                            "propertyId": 1,
                            "propertyName": "颜色",
                            "valueId": 20,
                            "valueName": "白沙银"
                        }
                    ]
                }
            }
        ],
        "invalidList": []
    },
    "msg": "成功"
}

响应说明​

购物车项字段：

参数类型说明
idLong购物项编号
countInteger商品数量
selectedBoolean是否选中
spuObject商品 SPU 信息
skuObject商品 SKU 信息

SPU 字段：

参数类型说明
idLong商品 SPU 编号
nameString商品 SPU 名称
picUrlString商品主图地址
categoryIdLong商品分类编号

SKU 字段：

参数类型说明
idLong商品 SKU 编号
picUrlString商品 SKU 图片地址
priceInteger销售价格，单位：分
marketPriceInteger市场价格，单位：分
stockInteger库存
propertiesArray属性数组（propertyId/propertyName/valueId/valueName）
说明
  • validList：有效的购物项（商品正常可售）。
  • invalidList：无效的购物项（商品已下架等），结构同有效购物项。

删除购物车商品​

批量删除购物车中的商品。

  • URL：/app-api/trade/cart/delete
  • Method：POST
  • 需要登录：是
  • 需要鉴权：是

请求参数​

参数类型约束说明
idsList<Long>必传购物车商品编号集合

请求示例​

{
    "ids": [97, 98]
}

响应示例​

{
    "code": 200,
    "data": true,
    "msg": "成功"
}

响应说明​

参数类型说明
dataBooleantrue 成功，false 失败

重置购物车商品​

当购物车项对应的商品失效（如 SPU 被下架），可以重新选择对应的 SKU。

  • URL：/app-api/trade/cart/reset
  • Method：POST
  • 需要登录：是
  • 需要鉴权：是

请求参数​

参数类型约束说明
idLong必传购物项编号
skuIdLong必传商品 SKU 编号
countInteger必传商品数量

请求示例​

{
    "id": 97,
    "skuId": 14,
    "count": 1
}

响应示例​

{
    "code": 200,
    "data": true,
    "msg": "成功"
}

响应说明​

参数类型说明
dataBooleantrue 成功，false 失败

获取购物车商品数量​

获取用户在购物车中的商品总数量。

  • URL：/app-api/trade/cart/get-count
  • Method：POST
  • 需要登录：是
  • 需要鉴权：是

请求参数​

无请求参数。

请求示例​

POST /app-api/trade/cart/get-count

响应示例​

{
    "code": 200,
    "data": 3,
    "msg": "成功"
}

响应说明​

参数类型说明
dataInteger购物车中的商品总数量