cart/change.json

简介

操作购物车中的商品进行加减操作

请求接口

请求方式

post

是否需要登录后才可使用

接口响应返回数据的格式

json

## 请求参数 | 参数名称 | 类型 | 示例值 | 必须 | 描述 | | ------------ | ------------ | ------------ | ------------ | ------------ | | goodsid | int | 1 | 是 | 要修改的购物车中商品的编号 | | changeNumber | int | 1 | 是 | 操作的商品是增加,还是减少,这里便是增加或者减少的数值。
正数 : 增加
负数,减少。最多能减少到0,如果到0,也就是将这个商品从购物车中清除掉了。例如,想要在购物车中清除掉某个商品,那么可以传入 -99999 | | storeid | int | 1 | 是 | 商铺编号,要获取的数据是属于哪个商铺的 | | token | String | dff4214c-4eca-42b8-ad9c-b95afd6374c0 | 是 | 当前操作用户的唯一标识。可用 [login/getToken.json](19770.html) 获取 | ## 返回结果 #### 返回示例 ```` { "result":1, "info":"success", "goodsCartMap":{ "6":{ "goods":{ "id":6, "title":"猪肉", "inventory":773, "putaway":1, "sale":1, "units":"斤", "price":1, "originalPrice":800, "addtime":1581919619, "storeid":1, "typeid":1, "titlepic":"http://www.xxxx.com/123.jpg", "userBuyRestrict":0 }, "number":16, "money":16, "selected":1, "exceptional":0, "exceptionalInfo":"" }, "11":{ "goods":{ "id":11, "title":"圣菲火(SHENGFEIHUO)手电筒小型", "inventory":1000, "putaway":1, "sale":20, "units":"个", "price":1, "originalPrice":2300, "addtime":1583049951, "storeid":1, "typeid":2, "titlepic":"http://www.xxxx.com/123.jpg", "userBuyRestrict":0 }, "number":1, "money":1, "selected":1, "exceptional":0, "exceptionalInfo":"" } }, "number":17, "money":17 } ```` #### 返回字段说明 | 参数名称 | 类型 | 示例值 | 描述 | | ------------ | ------------ | ------------ | ------------ | | result | int | 1 | 执行情况。
1:执行成功;
0:执行失败
| | info | String | success | 若result为0,这里返回失败的原因
若result为1,是执行成功,这里没有什么用 | | goodsCartMap | JSONObject | | 购物车中的商品信息。其中那个数字key是商品id | | number | int | | 用户在该店铺购物车中,已选中商品的数量总和 | | money | int | | 用户在该店铺购物车中,已选中商品的金额总和 | ##### goodsCartMap 中每项的值说明 key : 商品的id,也就是 goods.id value : 购物车中该商品的信息 | 参数名称 | 类型 | 示例值 | 描述 | | ------------ | ------------ | ------------ | ------------ | | goods | JSONObject | | 商品的信息 | | number | int | 1 | 此种商品数量,加入购物车中的数量 | | money | int | 100 | 此种商品加入购物车中的总金额,单位是分。也就是 goods.price * number 的值 | | selected | int | 1 | 当前商品是否在购物车中被已选择。
1:已选择(默认),
0:未选择。
在购物车界面,用户可以选择某些商品,进行结算,这里用户选上或者取消选择,这里就会跟着改变 | | exceptional | int | 0 | 当前商品是否是异常的, 0正常,可以正常下单,默认便是正常, >0则是异常,如商品库存不足,商品已下架等(预留,暂时没用到) | | exceptionalInfo | String | 商品已下架 | 异常信息,异常说明,比如 商品已下架(预留,暂时没用到) | ##### goods 中每项的值说明 | 参数名称 | 类型 | 示例值 | 描述 | | ------------ | ------------ | ------------ | ------------ | | id | int | 1 | 商品的id编号 | | title | String | 猪肉 | 商品的名称 | | inventory | int | 100 | 库存数量,有多少库存 | | putaway | int | 1 | 是否上架在售,1出售中,0已下架 | | sale | int | 10 | 已售数量。这个并不是真实的数量,有假的数量在内。这里是真实的已售数量跟商家管理后台中编辑商品时,自定义增加的假销售数量的和 | | units | String | 个 | 计量单位。如个、斤、条,限制5字符 | | price | int | 100 | 单价,单位是分,购买需要支付的价格 | | originalPrice | int | 100 | 原价,单位是分,仅仅只是看的,使用场景一般就是 显示出来一个原价,加一条删除线的效果 | | addtime | int | 1581919619 | 商品添加时间,10位时间戳 | | storeid | int | 1 | 店铺的id,该商品是属于哪个店铺的 | | typeid | int | 1 | 分类的id,该商品所属哪个分类的 | | titlepic | String | http://www.xxxx.com/123.jpg | 商品的标题图片(列表图片)比如在商品列表页面中所显示的商品图 | | userBuyRestrict | int | 0 | 用户购买限制。如果值是0,则可以任意购买,没有什么限制,如果是1,则代表每个用户只能购买一个,如果是2,代表每个用户只能购买2个以内,不超过2个。 只要是下单了,未退单成功的,都算是购买了 |