document
API test

商品新增业务接口

POST
http://localhost:8091/item/saveItem

API description

前端传递参数分析

Description or Example

{ item: { images: "/2021/05/20/da0c1d4781c1499399f090da8b60f359.jpg,/2021/05/20/2ac1c34776a7465887eb019655354c3c.jpg" itemCatId: 560 num: "100" price: 718800 sellPoint: "【华为官方直供,至高12期免息0首付,原装正品】送华为原装无线充+运动蓝牙耳机+蓝牙音箱+三合一多功能数据线+钢化膜等!" title: "华为P40 Pro 5G手机【12期免息可选送豪礼】全网通智能手机" }, itemDesc: { itemDesc: "<ul><li>品牌:&nbsp;<a href=https://list.jd.com/list.html"....... " }, itemParam: { dynamicArray: [ {paramId: 1, paramVals: "亮黑色,釉白色"}, {paramId: 2, paramVals: "8GB+128GB,8GB+256GB"} ], staticArray: [ {"paramId": 3,"paramVals": "华为Mate 40 Pro"}, {"paramId": 4,"paramVals": "0.575kg"}..... ] } }

请求参数: 使用ItemVO对象接收

parameter
type
description
required
item
Item
商品基本信息对象封装 (不能为null)
required
itemDesc
ItemDesc
商品详情信息 (不能为null)
required
itemParam
ItemParam
商品参数信息 (不能为null)
required

Item对象

parameter
type
description
required
title
String
商品标题信息 (不能为null)
required
sellPoint
String
商品卖点信息 (不能为null)
required
price
Integer
商品价格信息 (不能为null 需要将数据扩大100倍)
required
num
Integer
商品数量信息 (不能为null)
required
images
String
商品图片地址信息(不能为null)
required
itemCatId
Integer
商品父级分类ID(不能为null)
required
status
Boolean
商品状态信息(不能为null)
required

itemDesc 对象

parameter
type
description
required
1
string
为了降低商品提交代码的耦合性,将大字段信息详情,采用ItemDesc对象进行封装
required
id
Integer
商品Id信息 (因为Item和ItemDesc是一对一关系 所以需要依赖Item对象的Id值)
required
itemDesc
String
商品详情信息 (内部包含了大量的html语句)
required

itemParam对象

parameter
type
description
required
1
string
由于每个商品的动态参数和静态属性都不相同.所以需要单独封装
required
id
Integer
商品Id信息 (前端传值为null 因为Item和ItemParam是一对一关系 所以需要依赖Item对象的Id值,)
required
dynamicArgs
string
前端传值为null 将商品所有的动态参数进行封装(将dynamicArray使用JSON格式保存 格式如下: [ {“paramId”:1,“paramVals”:“亮黑色,黑色”}, {“paramId”:2,“paramVals”:“8GB+128GB,8GB+512GB”}])
required
staticArgs
String
将商品所有的静态属性进行封装(前端传值为null 将staticArray使用JSON格式保存 格式如下: [ { “paramId”:3,“paramVals”:“华为Mate 40 Pro”},{“paramId”:4,“paramVals”:“0.575kg”}] 前端传值为null)
required
dynamicArray
String
用来接收页面提交的动态参数信息 (该参数不是数据库记录,只用作参数接收)
required
staticArray
String
用来接收页面提交的静态属性信息(该参数不是数据库记录,只用作参数接收)
required

ItemParamVO对象

parameter
type
description
required
paramId
Integer
商品参数Id (不能为null)
required
paramVals
String
商品参数的值(不能为null)
required

返回值结果:

parameter
type
description
required
status
状态信息
200表示服务器请求成功 201表示服务器异常
required
msg
服务器返回的提示信息
可以为null
required
data
服务器返回的业务数据
可以为null
required