商城
  1. 购物车 -> 购物车
商城
  • 评论
    • productReview
      POST
    • reviewSkuList
      POST
    • reviewLike
      POST
    • reviewTag
      POST
    • orderDetail
      POST
    • 图片或视频上传或其他类型文件上传
      POST
    • 图片
      POST
    • 评论提交
      POST
    • 评论详情
      POST
    • 评论翻译
      POST
  • souring相关
    • 站点->sourcing
      • 商品 -> 图片搜索
        • 阿里云以图搜图
        • 阿里云以图搜图V2
      • sourcing提交
      • sourcing详情
      • sourcing取消
      • sourcing分页查询
      • sourcing商品查询
  • 站点->sourcing
    • 数量查询
      POST
  • 购物车 -> 购物车
    • deteleCartSync
      POST
    • test
      POST
    • test2
      POST
    • 合并购物车
      POST
    • 查询购物车仓库列表
      POST
    • 查询购物车数量
      POST
    • 删除购物车
      POST
    • 更新免邮勾选
      POST
    • 移动到心愿单
      POST
    • 更新购物车
      POST
    • 加购购物车
      POST
    • studio样品加入购物车
      POST
    • 购物车列表查询
      POST
    • 查询spu下所有sku查询在购物车中的数量
      POST
    • 删除原来sku,新增sku
      POST
  • 个人中心->订单管理
    • 订单分页列表
    • 查看订单详情
    • 获取订单中已变成一包多件的商品详情
    • 同步item数据
    • 备货详情
    • Pay now待支付订单信息
    • 查看订单概览
    • 标记等待补货
    • 待支付订单信息
    • 缺货继续支付
    • 支付成功回显订单地址信息
    • 编辑订单地址
    • 订单备注
    • 导出发货清单
    • 从服务器下载已保存的checklist文件
    • 上传支付凭证
    • 获取订单图片zip下载链接
    • studio-获取订单发票信息
  • 产品->详情
    • 查询sku详情(列表页弹框)
    • 设置log
    • 查询sku详情(商品详情)
    • 计算商详sku价格
    • 批量获取商品详情
    • 批量获取供应商产品详情
    • 查询sku活动
    • 查询商品的活动配置折扣信息以及分类活动的code
    • 推荐商品
    • 推荐关键词
    • 图片压缩包
    • 墨西哥免邮商品刷新
    • 商品发货交货时效信息
    • 获取二维码的sku编码,判别二维码是否有效(是否查询的到产品)
    • 获取不同站点对应链接
    • 获取经常购买的商品
    • 遗失物品赔偿
    • 墨西哥商品利益点文案
    • 商品关联博客列表
  • 订单 -> 订单
    • create
    • google or apple
    • reorder
    • reviewToWish
    • getOrderList
    • orderAgeing
    • orderNumberGenerator
    • 获取订单优惠信息
  • 站点->支付方式
    • list
    • 根据站点获取paypal的clientId 默认是饰品站
    • 复制站点支付方式
  • 产品搜索->列表
    • 列表分页
    • 图搜商品
    • ERP分页查询
    • 查询类目
    • 根据类目ID查询关键字
    • 获取所有语言的属性名
    • 刷新属性缓存
    • 刷新关键字缓存
    • 用户历史关键词搜索查询
    • 热门关键词和分类搜索
    • 删除用户历史关键词搜索查询
    • 清除缓存关键词
    • 根据spues获取商品列表
    • 新人专享页面数据
    • 新人专享页面数据v2版本
    • 流失客户推广专题页模块
    • 流失客户推广专题页模块
    • 新人专享页面免邮门槛图片v2版本
    • 购买过查询
    • 历史浏览记录
  • 购物车 -> 结算
    • checkout
    • checkoutOptimization
    • prepareCheckout
    • loginCheckout
    • countryProhibition
    • countryProhibitionConfirm
    • ageingInfo
  • 商品详情->激光定制
    • 激光定制模板查询
    • 激光定制提交
    • 激光定制分页查询
    • 激光定制详情
  • 商品定制
    • 定制商品需求提交
    • 定制商品列表
    • 定制商品需求 详情
  • 多买多奖
    • 获取活动信息
  1. 购物车 -> 购物车

更新免邮勾选

POST
/st-cart/cart/free-ship-update

请求参数

Header 参数
platform
string 
可选
nh-version
string 
可选
Body 参数application/json
pageNum
integer 
可选
默认值:
1
pageSize
integer 
可选
默认值:
500
scanToAdd
integer 
可选
默认值:
0
type
integer 
可选
appCartKey
string 
可选
selectAll
integer 
可选
全选 - 1,全非选 0
deleteAll
integer 
删除全部有效商品
可选
deleteInvalidAll
integer 
可选
全选删除失效商品 - 1
skuInfoList
array[object (CartSkuInfoParam) {11}] 
购物车信息
可选
默认值:
new ArrayList<>()
cartId
integer 
主键
可选
number
integer 
用户购买的数量
可选
selected
integer 
是否选中了该商品
可选
sku
string 
sku
可选
price
number 
sku的价格
可选
spu
string 
spu
可选
type
integer 
类型
可选
weight
number 
weight
可选
cartQty
integer 
可选
购物车中的数量,reorder用来判断是否删除购物车
scanToAdd
integer 
可选
date
string 
可选
moveToWhishAll
integer 
全部移到心愿单
可选
spuList
array[string]
查询的spu
可选
spu
string 
可选
sourceSpu
string 
可选
共享sku使用
加购来源商品spu
skuList
array[string]
可选
sourceKeyword
string 
埋点用
可选
sourcePage
string 
可选
sourceType
string 
可选
utmInfo
string 
可选
pointUid
string 
可选
referrerUrl
string 
可选
logToken
string 
可选
customerId
integer 
可选
iso2
string 
可选
platform
string 
可选
appVersion
string 
可选
SalesProhibitionSkuList
array[string]
可选
默认值:
new ArrayList<>()
queryMxCount
integer 
可选
默认值:
0
freeShipAll
integer 
可选
sensorsPublicParam
object (SensorsPublicParam) 
神策埋点需要
可选
formerPageUrl
string 
前向来源链接
可选
formerFirstLevelPage
string 
前向一级页面
可选
visitorTypes
string 
新老访客类型
可选
formerModuleId
string 
前向模块id
可选
formerMktId
string 
前向模块下内容id
可选
currentPageTitle
string 
当前页面名称
可选
shipToCountry
string 
shipTo国家
可选
spm
string 
spm字段
可选
bhvType
string 
行为类型
可选
isLogin
boolean 
是否登录
可选
pushExternalBatchId
string 
可选
app push任务ID(埋点)
eventAttributionProperties
object (JSONObject) 
aws需要参数
可选
key
object (key) 
可选
normalConfirm
integer 
可选
批发计算, 1是 0否
默认值:
0
filterLabel
integer 
可选
过滤标签, 值为filterLabelList[i].value
用于购物车数据过滤
supplierGroup
boolean 
可选
是否按照供应商分组
用于按照供应商分组
supplierCode
string 
可选
是否按照供应商分组
用于按照供应商分组
labelList
array[integer]
可选
需要排除该标签才能使用的物流
默认值:
new ArrayList<>()
pushExternalBatchId
string 
可选
app push任务ID(埋点)
示例
{
    "pageNum": 1,
    "pageSize": 500,
    "scanToAdd": 0,
    "type": 0,
    "appCartKey": "string",
    "selectAll": 0,
    "deleteAll": 0,
    "deleteInvalidAll": 0,
    "skuInfoList": "new ArrayList<>()",
    "moveToWhishAll": 0,
    "spuList": [
        "string"
    ],
    "spu": "string",
    "sourceSpu": "string",
    "skuList": [
        "string"
    ],
    "sourceKeyword": "string",
    "sourcePage": "string",
    "sourceType": "string",
    "utmInfo": "string",
    "pointUid": "string",
    "referrerUrl": "string",
    "logToken": "string",
    "customerId": 0,
    "iso2": "string",
    "platform": "string",
    "appVersion": "string",
    "SalesProhibitionSkuList": "new ArrayList<>()",
    "queryMxCount": 0,
    "freeShipAll": 0,
    "sensorsPublicParam": {
        "formerPageUrl": "string",
        "formerFirstLevelPage": "string",
        "visitorTypes": "string",
        "formerModuleId": "string",
        "formerMktId": "string",
        "currentPageTitle": "string",
        "shipToCountry": "string",
        "spm": "string",
        "bhvType": "string",
        "isLogin": true,
        "pushExternalBatchId": "string"
    },
    "eventAttributionProperties": {
        "key": {}
    },
    "normalConfirm": 0,
    "filterLabel": 0,
    "supplierGroup": true,
    "supplierCode": "string",
    "labelList": "new ArrayList<>()",
    "pushExternalBatchId": "string"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://www.nihaocloud.cn/st-cart/cart/free-ship-update' \
--header 'Content-Type: application/json' \
--data-raw '{
    "pageNum": 1,
    "pageSize": 500,
    "scanToAdd": 0,
    "type": 0,
    "appCartKey": "string",
    "selectAll": 0,
    "deleteAll": 0,
    "deleteInvalidAll": 0,
    "skuInfoList": "new ArrayList<>()",
    "moveToWhishAll": 0,
    "spuList": [
        "string"
    ],
    "spu": "string",
    "sourceSpu": "string",
    "skuList": [
        "string"
    ],
    "sourceKeyword": "string",
    "sourcePage": "string",
    "sourceType": "string",
    "utmInfo": "string",
    "pointUid": "string",
    "referrerUrl": "string",
    "logToken": "string",
    "customerId": 0,
    "iso2": "string",
    "platform": "string",
    "appVersion": "string",
    "SalesProhibitionSkuList": "new ArrayList<>()",
    "queryMxCount": 0,
    "freeShipAll": 0,
    "sensorsPublicParam": {
        "formerPageUrl": "string",
        "formerFirstLevelPage": "string",
        "visitorTypes": "string",
        "formerModuleId": "string",
        "formerMktId": "string",
        "currentPageTitle": "string",
        "shipToCountry": "string",
        "spm": "string",
        "bhvType": "string",
        "isLogin": true,
        "pushExternalBatchId": "string"
    },
    "eventAttributionProperties": {
        "key": {}
    },
    "normalConfirm": 0,
    "filterLabel": 0,
    "supplierGroup": true,
    "supplierCode": "string",
    "labelList": "new ArrayList<>()",
    "pushExternalBatchId": "string"
}'

返回响应

🟢200成功
application/json
Body
com.nihao.sitecartweb.model.vo.CartInfoResultVo
customerId
integer 
可选
客户ID,未登录时为临时客户ID
qty
integer 
全部有效商品
可选
freeShipCount
integer 
免邮商品数量
可选
默认值:
0
selectQty
integer 
已选中的有效商品
可选
weight
number 
可选
购物车中已经被勾选的产品重量
vipDiscount
number 
可选
vip折扣
vip优惠的金额
mxInventoryMinSubTotal
number 
可选
墨西哥仓最小起订金额
originalPrice
number 
无任何折扣的总价
可选
discountPrice
number 
折后总价
可选
message
string 
执行反馈信息
可选
inventoryList
array[object (CartInventoryInfoVo) {8}] 
仓库列表信息
可选
type
integer 
类型
可选
title
string 
标题
可选
delivery_time
integer 
到货时间
可选
defaulted
integer 
1默认 默认购物车
可选
min_amount
number 
最金额
可选
min_amount_currency
string 
最小金额货币
可选
count
integer 
购物车items数
可选
默认值:
0
notice
string 
提示
可选
cartList
array[object (CartProductInfoVo) {46}] 
购物车列表
可选
默认值:
new ArrayList<>()
cartId
integer 
可选
购物车下的产品维护表的主键
productName
string 
产品名称
可选
activityCode
array[integer]
活动编码列表
可选
spu
string 
产品spu
可选
url
string 
产品网页跳转路径
可选
sku
string 
产品sku
可选
suppllyCode
string 
供应商编码
可选
image
string 
图片路径地址
可选
price
number 
商品原价
可选
discountPrice
number 
折后价
可选
limitDiscountPrompt
string 
限购折扣提示
可选
multipleDiscountPrice
number 
折后总价
可选
number
integer 
可选
该sku商品购买的数量
offLimitNumber
integer 
可选
折扣显示数量
折扣限购数量
multipleOffLimitDiscountPrice
number 
折扣限购总价
可选
invalid
integer 
是否失效
可选
inventory
integer 
产品库存
可选
outOfNum
integer 
缺货数
可选
默认值:
0
miniSale
integer 
最小起订量
可选
selected
integer 
是否选中了该商品
可选
默认值:
0
skuSpec
string 
显示sku字段
可选
embargoLabel
integer 
禁运标签
可选
embargoLabelVo
object (ProductLabelVo) 
可选
com.nihao.sitecartweb.model.vo.CartInfoResultVo
isCustomize
boolean 
可选
是否定制
是否定制 true是
isLaserCustomize
boolean 
可选
是否激光定制 true是激光定制
invalidType
integer 
产品的失效类型
可选
createdAt
string 
可选
该商品添加购物车的时间
updatedAt
string 
可选
该商品添加购物车的时间
scanToAdd
integer 
可选
通过扫描sku二维码添加购物车的标识,默认为0,扫描二维码时前端传1
multipleWeight
number 
多个重量
可选
weight
number 
单个重量
可选
inventoryType
integer 
库存类型
可选
stockType
integer 
商品仓库类型
可选
discount
number 
可选
折扣,85折返回 0.87
freeShip
integer 
是否免邮
可选
默认值:
0
productNameEnUrl
string 
商品英文名Url
可选
inventoryShow
integer 
是否展示库存
可选
默认值:
0
inventoryPrompt
string 
库存加超提示语
可选
inventoryLimit
integer 
是否库存限制
可选
默认值:
0
batchSale
integer 
一包多件商品起批量
可选
goodsCode
string 
货品spu
可选
goodsSkuCode
string 
货品sku
可选
onShareSpu
string 
可选
sku共享被挂spu
sourceKeyword
string 
加购词
可选
sourcePage
string 
加购页面
可选
sourceType
string 
加购词类型
可选
invalidCartList
array[object (CartProductInfoVo) {46}] 
购物车中的失效商品
可选
cartId
integer 
可选
购物车下的产品维护表的主键
productName
string 
产品名称
可选
activityCode
array[integer]
活动编码列表
可选
spu
string 
产品spu
可选
url
string 
产品网页跳转路径
可选
sku
string 
产品sku
可选
suppllyCode
string 
供应商编码
可选
image
string 
图片路径地址
可选
price
number 
商品原价
可选
discountPrice
number 
折后价
可选
limitDiscountPrompt
string 
限购折扣提示
可选
multipleDiscountPrice
number 
折后总价
可选
number
integer 
可选
该sku商品购买的数量
offLimitNumber
integer 
可选
折扣显示数量
折扣限购数量
multipleOffLimitDiscountPrice
number 
折扣限购总价
可选
invalid
integer 
是否失效
可选
inventory
integer 
产品库存
可选
outOfNum
integer 
缺货数
可选
默认值:
0
miniSale
integer 
最小起订量
可选
selected
integer 
是否选中了该商品
可选
默认值:
0
skuSpec
string 
显示sku字段
可选
embargoLabel
integer 
禁运标签
可选
embargoLabelVo
object (ProductLabelVo) 
可选
com.nihao.sitecartweb.model.vo.CartInfoResultVo
isCustomize
boolean 
可选
是否定制
是否定制 true是
isLaserCustomize
boolean 
可选
是否激光定制 true是激光定制
invalidType
integer 
产品的失效类型
可选
createdAt
string 
可选
该商品添加购物车的时间
updatedAt
string 
可选
该商品添加购物车的时间
scanToAdd
integer 
可选
通过扫描sku二维码添加购物车的标识,默认为0,扫描二维码时前端传1
multipleWeight
number 
多个重量
可选
weight
number 
单个重量
可选
inventoryType
integer 
库存类型
可选
stockType
integer 
商品仓库类型
可选
discount
number 
可选
折扣,85折返回 0.87
freeShip
integer 
是否免邮
可选
默认值:
0
productNameEnUrl
string 
商品英文名Url
可选
inventoryShow
integer 
是否展示库存
可选
默认值:
0
inventoryPrompt
string 
库存加超提示语
可选
inventoryLimit
integer 
是否库存限制
可选
默认值:
0
batchSale
integer 
一包多件商品起批量
可选
goodsCode
string 
货品spu
可选
goodsSkuCode
string 
货品sku
可选
onShareSpu
string 
可选
sku共享被挂spu
sourceKeyword
string 
加购词
可选
sourcePage
string 
加购页面
可选
sourceType
string 
加购词类型
可选
spuCountList
array[object (SpuCountVo) {2}] 
可选
查询spu在购物车的数量
spu
string 
可选
count
integer 
可选
pages
integer 
页数
可选
currentTime
integer 
可选
locale
string 
仓库地址
可选
selectedAll
integer 
可选
默认值:
0
yiwuSelectedAll
integer 
可选
默认值:
0
chinaSelectedAll
integer 
可选
默认值:
0
total
integer 
可选
默认值:
0
copywriter
string 
满折满减文案
可选
marketingDiscout
number 
满折
可选
marketingDiscountPrice
number 
满减
可选
subTitleList
array[object (ShippingAgeingSubVo) {2}] 
可选
title
string 
可选
inventoryType
integer 
可选
maxShippingDays
string 
可选
shipping24
string 
可选
mxQty
integer 
墨西哥仓数量
可选
默认值:
0
freeShipPrompt
string 
可选
freeShipSelectedAll
integer 
可选
默认值:
0
freeShipWeight
number 
免邮重量
可选
filterLabelList
array[object (CartFilterLabelVo) {5}] 
标签过滤列表
可选
name
string 
标签名称
可选
value
integer 
标签值
可选
selectAll
integer 
可选
当前标签过滤是否全选
count
integer 
可选
当前标签过滤购物车数量
prompt
string 
提示
可选
promotionSummaryList
array[object (PromotionSummaryDTO) {3}] 
促销汇总明细
可选
code
enum<integer> 
可选
折扣类型
折扣类型 10 单品直降;11 VIP折扣;12 FlashDeal折扣;13 阶梯售价折扣;14 新人专享折扣;20 运费补贴;21 常驻运费折扣;30 订单满减;31 常驻大订单折扣
枚举值:
1011121314151620213031
name
string 
折扣类型名称
可选
discountMoney
number 
优惠金额
可选
promotionAccess
boolean 
促销接入
可选
cartSupplierList
array[object (SupplierCartProductInfoVo) {2}] 
可选
购物车列表按供应商分组
默认值:
new ArrayList<>()
supplierDTO
object (SupplierDTO) 
可选
com.nihao.sitecartweb.model.vo.CartInfoResultVo
cartList
array[object (CartProductInfoVo) {46}] 
可选
示例
{
  "customerId": 0,
  "qty": 0,
  "freeShipCount": 0,
  "selectQty": 0,
  "weight": 0.0,
  "vipDiscount": 0.0,
  "mxInventoryMinSubTotal": 0.0,
  "originalPrice": 0.0,
  "discountPrice": 0.0,
  "message": "",
  "inventoryList": [
    {
      "type": 0,
      "title": "",
      "delivery_time": 0,
      "defaulted": 0,
      "min_amount": 0.0,
      "min_amount_currency": "",
      "count": 0,
      "notice": ""
    }
  ],
  "cartList": [
    {
      "cartId": 0,
      "productName": "",
      "activityCode": [
        0
      ],
      "spu": "",
      "url": "",
      "sku": "",
      "suppllyCode": "",
      "image": "",
      "price": 0.0,
      "discountPrice": 0.0,
      "multipleDiscountPrice": 0.0,
      "number": 0,
      "offLimitNumber": 0,
      "multipleOffLimitDiscountPrice": 0.0,
      "invalid": 0,
      "inventory": 0,
      "outOfNum": 0,
      "miniSale": 0,
      "selected": 0,
      "skuSpec": "",
      "embargoLabel": 0,
      "embargoLabelVo": {
        "icon": "",
        "prompt": ""
      },
      "isCustomize": false,
      "invalidType": 0,
      "createdAt": "",
      "updatedAt": "",
      "scanToAdd": 0,
      "multipleWeight": 0.0,
      "weight": 0.0,
      "inventoryType": 0,
      "stockType": 0,
      "discount": 0.0,
      "freeShip": 0,
      "productNameEnUrl": "",
      "inventoryShow": 0,
      "inventoryPrompt": "",
      "inventoryLimit": 0,
      "batchSale": 0,
      "goodsCode": "",
      "goodsSkuCode": "",
      "onShareSpu": ""
    }
  ],
  "invalidCartList": [
    {
      "cartId": 0,
      "productName": "",
      "activityCode": [
        0
      ],
      "spu": "",
      "url": "",
      "sku": "",
      "suppllyCode": "",
      "image": "",
      "price": 0.0,
      "discountPrice": 0.0,
      "multipleDiscountPrice": 0.0,
      "number": 0,
      "offLimitNumber": 0,
      "multipleOffLimitDiscountPrice": 0.0,
      "invalid": 0,
      "inventory": 0,
      "outOfNum": 0,
      "miniSale": 0,
      "selected": 0,
      "skuSpec": "",
      "embargoLabel": 0,
      "embargoLabelVo": {
        "icon": "",
        "prompt": ""
      },
      "isCustomize": false,
      "invalidType": 0,
      "createdAt": "",
      "updatedAt": "",
      "scanToAdd": 0,
      "multipleWeight": 0.0,
      "weight": 0.0,
      "inventoryType": 0,
      "stockType": 0,
      "discount": 0.0,
      "freeShip": 0,
      "productNameEnUrl": "",
      "inventoryShow": 0,
      "inventoryPrompt": "",
      "inventoryLimit": 0,
      "batchSale": 0,
      "goodsCode": "",
      "goodsSkuCode": "",
      "onShareSpu": ""
    }
  ],
  "spuCountList": [
    {
      "spu": "",
      "count": 0
    }
  ],
  "pages": 0,
  "currentTime": 0,
  "locale": "",
  "selectedAll": 0,
  "yiwuSelectedAll": 0,
  "chinaSelectedAll": 0,
  "total": 0,
  "copywriter": "",
  "marketingDiscout": 0.0,
  "marketingDiscountPrice": 0.0,
  "subTitleList": [
    {
      "title": "",
      "inventoryType": 0
    }
  ],
  "maxShippingDays": "",
  "shipping24": "",
  "mxQty": 0,
  "freeShipPrompt": "",
  "freeShipSelectedAll": 0,
  "freeShipWeight": 0.0,
  "filterLabelList": [
    {
      "name": "",
      "value": 0,
      "selectAll": 0,
      "count": 0,
      "prompt": ""
    }
  ],
  "promotionSummaryList": [
    {
      "code": 0,
      "name": "",
      "discountMoney": 0.0
    }
  ],
  "promotionAccess": false,
  "cartSupplierList": [
    {
      "supplierDTO": {
        "supplierCode": "",
        "warehouseTime": 0,
        "holiday_start_time": "",
        "holiday_end_time": "",
        "delivery_time": "",
        "delivery_start_time": "",
        "supplierName": "",
        "supplierImg": "",
        "selectAll": 0,
        "holidayType": 0
      },
      "cartList": [
        {
          "cartId": 0,
          "productName": "",
          "activityCode": [
            0
          ],
          "spu": "",
          "url": "",
          "sku": "",
          "suppllyCode": "",
          "image": "",
          "price": 0.0,
          "discountPrice": 0.0,
          "multipleDiscountPrice": 0.0,
          "number": 0,
          "offLimitNumber": 0,
          "multipleOffLimitDiscountPrice": 0.0,
          "invalid": 0,
          "inventory": 0,
          "outOfNum": 0,
          "miniSale": 0,
          "selected": 0,
          "skuSpec": "",
          "embargoLabel": 0,
          "embargoLabelVo": {
            "icon": "",
            "prompt": ""
          },
          "isCustomize": false,
          "invalidType": 0,
          "createdAt": "",
          "updatedAt": "",
          "scanToAdd": 0,
          "multipleWeight": 0.0,
          "weight": 0.0,
          "inventoryType": 0,
          "stockType": 0,
          "discount": 0.0,
          "freeShip": 0,
          "productNameEnUrl": "",
          "inventoryShow": 0,
          "inventoryPrompt": "",
          "inventoryLimit": 0,
          "batchSale": 0,
          "goodsCode": "",
          "goodsSkuCode": "",
          "onShareSpu": ""
        }
      ]
    }
  ]
}
修改于 2025-05-22 06:16:33
上一页
删除购物车
下一页
移动到心愿单
Built with