后台管理接口-购物车模块

上级目录:购物车模块

具体返回字段意思参见cart购物车表

返回状态码

1. 方法范例

  • 请求路径: /cart/list.do
  • 请求方法:GET
  • 请求参数:

  • 响应成功
  • 响应失败

2. 通过商品ID和商品数量在购物车添加商品

  • 请求路径: /cart/add.do
  • 请求方法:POST
  • 请求参数:

productId,商品ID
count,购物车中商品数量

  • 响应成功
{
    "status": 0,//返回状态码,成功
    "data": {
        "cartProductVoList": [//购物车记录列表
            {
                "id": 150,	//某一条记录ID
                "userId": 1,//所属用户编号
                "productId": 26,//所属产品编号
                "quantity": 160,//该购物车记录中购买商品数量
                "productName": "Apple iPhone 7 Plus (A1661) 128G 玫瑰金色 移动联通电信4G手机",//商品名
                "productSubtitle": "iPhone 7,现更以红色呈现。",//商品副标题
                "productMainImage": "626dceb4-398e-481b-80e5-4339c3708a6e.jpg",//商品列表显示主图
                "productPrice": 6999.00,//商品价格
                "productStatus": 1,//商品状态,1在售,2下架,3删除
                "productChecked": 1,//购物车记录选中状态
                "productStock": 9991,//该条记录商品库存
                "productTotalPrice": 1119840.00,//该条记录所选商品总价格
                "limitQuantity": "LIMIT_NUM_SUCCESS"//选择商品数量是否超过库存,如果是LIMIT_NUM_SUCCESS则没有超过,按照自己添加的商品数修改quantity属性,但是如果购买数量如果超过库存数量,则返回LIMIT_NUM_FAIL,并且购买商品数量强制与库存数量持平。可根据这个字段给予提示
            }
        ],
        
        "cartTotalPrice": 1119840.0,//所有购物车商品记录价格总和
        "allChecked": true,是否处于全选状态,会根据是否有记录处于未被选中状态自动判断
        "imageHost": "121.36.145.230"//文件服务器地址
    }
}
{
    "status": 0,
    "data": {
        "cartProductVoList": [
            {
                "id": 150,
                "userId": 1,
                "productId": 26,
                "quantity": 170,
                "productName": "Apple iPhone 7 Plus (A1661) 128G 玫瑰金色 移动联通电信4G手机",
                "productSubtitle": "iPhone 7,现更以红色呈现。",
                "productMainImage": "626dceb4-398e-481b-80e5-4339c3708a6e.jpg",
                "productPrice": 6999.00,
                "productStatus": 1,
                "productChecked": 1,
                "productStock": 170,
                "productTotalPrice": 1259820.00,
                "limitQuantity": "LIMIT_NUM_FAIL"
            }
        ],
        "cartTotalPrice": 1259820.0,
        "allChecked": true,
        "imageHost": "121.36.145.230"
    }
}
  • 响应失败
{
    "status": 10,
    "msg": "NEED_LOGIN"
}

2. 无条件获取购物车列表

  • 请求路径: /cart/list.do
  • 请求方法:GET
  • 请求参数:

无参数,需要登录

  • 响应成功
{
    "status": 0,
    "data": {
        "cartProductVoList": [
            {
                "id": 150,
                "userId": 1,
                "productId": 26,
                "quantity": 170,
                "productName": "Apple iPhone 7 Plus (A1661) 128G 玫瑰金色 移动联通电信4G手机",
                "productSubtitle": "iPhone 7,现更以红色呈现。",
                "productMainImage": "626dceb4-398e-481b-80e5-4339c3708a6e.jpg",
                "productPrice": 6999.00,
                "productStatus": 1,
                "productChecked": 1,
                "productStock": 170,
                "productTotalPrice": 1189830.00,
                "limitQuantity": "LIMIT_NUM_SUCCESS"
            },
            {
                "id": 151,
                "userId": 1,
                "productId": 27,
                "quantity": 30,
                "productName": "Midea/美的 BCD-535WKZM(E)冰箱双开门对开门风冷无霜智能电家用",
                "productSubtitle": "送品牌烤箱,五一大促",
                "productMainImage": "626dceb4-398e-481b-80e5-4339c3708a6e.jpg",
                "productPrice": 3299.00,
                "productStatus": 1,
                "productChecked": 1,
                "productStock": 8876,
                "productTotalPrice": 98970.00,
                "limitQuantity": "LIMIT_NUM_SUCCESS"
            }
        ],
        "cartTotalPrice": 1288800.0,
        "allChecked": true,
        "imageHost": "121.36.145.230"
    }
}
  • 响应失败
{
    "status": 10,
    "msg": "NEED_LOGIN"
}

3. 更新购物车某个商品的数量

  • 请求路径: /cart/update.do
  • 请求方法:PUT
  • 请求参数:

productId,商品ID
count,购物车中商品数量

  • 响应成功
{
    "status": 0,
    "data": {
        "cartProductVoList": [
            {
                "id": 150,
                "userId": 1,
                "productId": 26,
                "quantity": 10,
                "productName": "Apple iPhone 7 Plus (A1661) 128G 玫瑰金色 移动联通电信4G手机",
                "productSubtitle": "iPhone 7,现更以红色呈现。",
                "productMainImage": "626dceb4-398e-481b-80e5-4339c3708a6e.jpg",
                "productPrice": 6999.00,
                "productStatus": 1,
                "productChecked": 1,
                "productStock": 170,
                "productTotalPrice": 69990.00,
                "limitQuantity": "LIMIT_NUM_SUCCESS"
            },
            {
                "id": 151,
                "userId": 1,
                "productId": 27,
                "quantity": 30,
                "productName": "Midea/美的 BCD-535WKZM(E)冰箱双开门对开门风冷无霜智能电家用",
                "productSubtitle": "送品牌烤箱,五一大促",
                "productMainImage": "626dceb4-398e-481b-80e5-4339c3708a6e.jpg",
                "productPrice": 3299.00,
                "productStatus": 1,
                "productChecked": 1,
                "productStock": 8876,
                "productTotalPrice": 98970.00,
                "limitQuantity": "LIMIT_NUM_SUCCESS"
            }
        ],
        "cartTotalPrice": 168960.0,
        "allChecked": true,
        "imageHost": "121.36.145.230"
    }
}
  • 响应失败
{
    "status": 10,
    "msg": "用户未登录,请登录"
}

4. 列表移除购物车商品

  • 请求路径: /cart/delete_product.do
  • 请求方法:DELETE
  • 请求参数:

productIds,String类型的productId(商品列表),需要前端按照约定使用逗号分隔!!

  • 响应成功
    可以看到26消失
{
    "status": 0,
    "data": {
        "cartProductVoList": [
            {
                "id": 151,
                "userId": 1,
                "productId": 27,
                "quantity": 30,
                "productName": "Midea/美的 BCD-535WKZM(E)冰箱双开门对开门风冷无霜智能电家用",
                "productSubtitle": "送品牌烤箱,五一大促",
                "productMainImage": "626dceb4-398e-481b-80e5-4339c3708a6e.jpg",
                "productPrice": 3299.00,
                "productStatus": 1,
                "productChecked": 1,
                "productStock": 8876,
                "productTotalPrice": 98970.00,
                "limitQuantity": "LIMIT_NUM_SUCCESS"
            }
        ],
        "cartTotalPrice": 98970.0,
        "allChecked": true,
        "imageHost": "121.36.145.230"
    }
}
  • 响应失败
{
    "status": 10,
    "msg": "用户未登录,请登录"
}

5. 选中购物车中某个商品

  • 请求路径: /cart/select.do
  • 请求方法:POST
  • 请求参数:

productId,商品编号

  • 响应成功
{
    "status": 0,
    "data": {
        "cartProductVoList": [
            {
                "id": 151,
                "userId": 1,
                "productId": 27,
                "quantity": 30,
                "productName": "Midea/美的 BCD-535WKZM(E)冰箱双开门对开门风冷无霜智能电家用",
                "productSubtitle": "送品牌烤箱,五一大促",
                "productMainImage": "626dceb4-398e-481b-80e5-4339c3708a6e.jpg",
                "productPrice": 3299.00,
                "productStatus": 1,//这是商品上下架逻辑,1表示上架在售,2下架,3删除
                "productChecked": 1,//这是购物车记录选中状态,1选中,0反选
                "productStock": 8876,
                "productTotalPrice": 98970.00,
                "limitQuantity": "LIMIT_NUM_SUCCESS"
            }
        ],
        "cartTotalPrice": 98970.0,
        "allChecked": true,
        "imageHost": "121.36.145.230"
    }
}
  • 响应失败
{
    "status": 10,
    "msg": "用户未登录,请登录"
}

6. 购物车取消选中某个商品

  • 请求路径: /cart/un_select.do
  • 请求方法:POST
  • 请求参数:

productId,商品编号

  • 响应成功
{
    "status": 0,
    "data": {
        "cartProductVoList": [
            {
                "id": 151,
                "userId": 1,
                "productId": 27,
                "quantity": 30,
                "productName": "Midea/美的 BCD-535WKZM(E)冰箱双开门对开门风冷无霜智能电家用",
                "productSubtitle": "送品牌烤箱,五一大促",
                "productMainImage": "626dceb4-398e-481b-80e5-4339c3708a6e.jpg",
                "productPrice": 3299.00,
                "productStatus": 1,//这是商品上下架逻辑,1表示上架在售,2下架,3删除
                "productChecked": 0,//这是购物车记录选中状态,1选中,0反选
                "productStock": 8876,
                "productTotalPrice": 98970.00,
                "limitQuantity": "LIMIT_NUM_SUCCESS"
            }
        ],
        "cartTotalPrice": 98970.0,
        "allChecked": true,
        "imageHost": "121.36.145.230"
    }
}
  • 响应失败
{
    "status": 10,
    "msg": "用户未登录,请登录"
}

7. 查询购物车中产品的数量

  • 请求路径: /cart/get_cart_product_count.do
  • 请求方法:GET
  • 请求参数:

无,需要登录

  • 响应成功
{
    "status": 0,
    "data": 30//最好在右上角购物车那里显示,即参考淘宝
}
  • 响应失败
{
    "status": 10,
    "msg": "出现异常"
}

8. 购物车全选

  • 请求路径: /cart/select_all.do
  • 请求方法:GET
  • 请求参数:

无,需要登录,全选之后总价会发生改变

  • 响应成功
{
    "status": 0,
    "data": {
        "cartProductVoList": [
            {
                "id": 151,
                "userId": 1,
                "productId": 27,
                "quantity": 30,
                "productName": "Midea/美的 BCD-535WKZM(E)冰箱双开门对开门风冷无霜智能电家用",
                "productSubtitle": "送品牌烤箱,五一大促",
                "productMainImage": "626dceb4-398e-481b-80e5-4339c3708a6e.jpg",
                "productPrice": 3299.00,
                "productStatus": 1,
                "productChecked": 1,//是否选中的状态
                "productStock": 8876,
                "productTotalPrice": 98970.00,
                "limitQuantity": "LIMIT_NUM_SUCCESS"
            },
            {
                "id": 152,
                "userId": 1,
                "productId": 26,
                "quantity": 10,
                "productName": "Apple iPhone 7 Plus (A1661) 128G 玫瑰金色 移动联通电信4G手机",
                "productSubtitle": "iPhone 7,现更以红色呈现。",
                "productMainImage": "626dceb4-398e-481b-80e5-4339c3708a6e.jpg",
                "productPrice": 6999.00,
                "productStatus": 1,
                "productChecked": 1,//是否选中的状态
                "productStock": 170,
                "productTotalPrice": 69990.00,
                "limitQuantity": "LIMIT_NUM_SUCCESS"
            }
        ],
        "cartTotalPrice": 168960.0,//总价格随之改变
        "allChecked": true,//是否全选的状态
        "imageHost": "121.36.145.230"
    }
}
  • 响应失败
{
    "status": 10,
    "msg": "出现异常"
}

9. 购物车全反选

  • 请求路径: /cart/un_select_all.do
  • 请求方法:GET
  • 请求参数:

无,需要登录,全选之后总价会发生改变

  • 响应成功
{
    "status": 0,
    "data": {
        "cartProductVoList": [
            {
                "id": 151,
                "userId": 1,
                "productId": 27,
                "quantity": 30,
                "productName": "Midea/美的 BCD-535WKZM(E)冰箱双开门对开门风冷无霜智能电家用",
                "productSubtitle": "送品牌烤箱,五一大促",
                "productMainImage": "626dceb4-398e-481b-80e5-4339c3708a6e.jpg",
                "productPrice": 3299.00,
                "productStatus": 1,
                "productChecked": 0,//是否选中的状态
                "productStock": 8876,
                "productTotalPrice": 98970.00,
                "limitQuantity": "LIMIT_NUM_SUCCESS"
            },
            {
                "id": 152,
                "userId": 1,
                "productId": 26,
                "quantity": 10,
                "productName": "Apple iPhone 7 Plus (A1661) 128G 玫瑰金色 移动联通电信4G手机",
                "productSubtitle": "iPhone 7,现更以红色呈现。",
                "productMainImage": "626dceb4-398e-481b-80e5-4339c3708a6e.jpg",
                "productPrice": 6999.00,
                "productStatus": 1,
                "productChecked": 0,//是否选中的状态
                "productStock": 170,
                "productTotalPrice": 69990.00,
                "limitQuantity": "LIMIT_NUM_SUCCESS"
            }
        ],
        "cartTotalPrice": 0,//总价格随之改变
        "allChecked": false,//是否全选的状态
        "imageHost": "121.36.145.230"
    }
}
  • 响应失败
{
    "status": 10,
    "msg": "出现异常"
}
原创文章 243 获赞 156 访问量 2万+

猜你喜欢

转载自blog.csdn.net/weixin_43404791/article/details/105966463