接口文档：第一章：简洁版接口文档

ApiAddressController|收货地址管理控制器

获取收货地址列表信息

接口说明:通过用户名获取地址列表信息

接口地址:/address/find

请求方式：GET

请求参数：无

添加或更新收货地址

接口说明:添加或更新收货地址，有addressID为更新，没有addressID为添加

接口地址:/address/save

请求方式：POST

请求参数：

参数名称	说明	in	是否必须	类型
address	地址	query	true	Address

删除收货地址

接口说明:根据addressID删除收货地址

接口地址:/address/delete

请求方式：POST

请求参数：

参数名称	说明	in	是否必须	类型
addressID	地址ID	query	true	Long

ApiTypeTemplateController|模板管理控制器

删除模板

接口说明:根据模板ID删除模板信息

接口地址:/typeTemplate/delete

请求方式：GET

请求参数：

参数名称	说明	in	是否必须	类型
ids	模板id数组	header	true	Long[]

根据搜索条件获取模板分页列表

接口说明:根据搜索条件获取模板分页列表

接口地址:/typeTemplate/search

请求方式：POST

请求参数：

参数名称	说明	in	是否必须	类型
typeTemplate	模板对象	header	false	TypeTemplate
page	页数	header	true	int
rows	条数	header	true	int

根据模板id获取模板信息

接口说明:根据模板ID查询模板信息

接口地址:/typeTemplate/getTypeTemplate

请求方式：GET

请求参数：

参数名称	说明	in	是否必须	类型
id	模板id	header	true	Long

添加模板

接口说明:添加模板数据

接口地址:/typeTemplate/save

请求方式：POST

请求参数：

参数名称	说明	in	是否必须	类型
typeTemplate	模板对象	header	true	TypeTemplate

更新模板

接口说明:更新模板信息

接口地址:/typeTemplate/update

请求方式：POST

请求参数：

参数名称	说明	in	是否必须	类型
typeTemplate	模板对象	header	true	TypeTemplate

ApiBrandController|品牌管理控制器

删除品牌

接口说明:根据品牌ID删除品牌信息

接口地址:/brand/delete

请求方式：GET

请求参数：

参数名称	说明	in	是否必须	类型
ids	品牌id数组	header	true	Long[]

根据搜索条件获取品牌分页列表

接口说明:根据搜索条件获取品牌分页列表

接口地址:/brand/search

请求方式：POST

请求参数：

参数名称	说明	in	是否必须	类型
brand	品牌对象	header	false	Brand
page	页数	header	true	int
rows	条数	header	true	int

根据品牌id获取品牌信息

接口说明:根据品牌ID查询品牌信息

接口地址:/brand/getBrand

请求方式：GET

请求参数：

参数名称	说明	in	是否必须	类型
id	品牌id	header	true	Long

添加品牌

接口说明:添加品牌数据

接口地址:/brand/save

请求方式：POST

请求参数：

参数名称	说明	in	是否必须	类型
brand	品牌对象	header	true	Brand

更新品牌

接口说明:更新品牌信息

接口地址:/brand/update

请求方式：POST

请求参数：

参数名称	说明	in	是否必须	类型
brand	品牌对象	header	true	Brand

ApiCartController|用户购物车管理控制器

获取购物车中的数据

接口说明:获取购物车中的数据

接口地址:/cart/getCart

请求方式：GET

请求参数：

参数名称	说明	in	是否必须	类型
sellerId	店铺ID	query	true	Long

添加购物车跳转添加成功页面

接口说明:通过skuID和数量添加购物车并跳转添加成功页面

接口地址:/cart/addCartToPage

请求方式：GET

请求参数：

参数名称	说明	in	是否必须	类型
num	数量	query	true	Integer
skuId	商品库存ID	query	true	Long

添加购物车不跳转页面

接口说明:通过skuID和数量添加购物车增加购物车商品数量

接口地址:/cart/addCartNum

请求方式：GET

请求参数：

参数名称	说明	in	是否必须	类型
num	数量	query	true	Integer
skuId	商品库存ID	query	true	Long

删除购物车

接口说明:删除选中的购物车商品，批量删除

接口地址:/cart/delete

请求方式：POST

请求参数：

参数名称	说明	in	是否必须	类型
skuId	商品库存ID	query	true	Long

ApiCatalogController|商品分类管理控制器

首页商品分类

接口说明:获取首页分类下的所有子分类

接口地址:/catalog/getCatalog

请求方式：GET

请求参数：

参数名称	说明	in	是否必须	类型
address	地址	query	true	Address

三级分类下的商品分类筛选列表

接口说明:根据三级分类id获取三级分类下的所有商品信息

接口地址:/catalog/getGoodsByID

请求方式：GET

请求参数：无

筛选后的商品信息

接口说明:根据筛选条件获取筛选后的商品信息

接口地址:/catalog/getGoodsByAttribute

请求方式：POST

请求参数：

参数名称	说明	in	是否必须	类型
attribute	属性对象	query	true	Attribute

删除商品分类

接口说明:根据商品分类ID删除商品分类信息

接口地址:/catalog/delete

请求方式：GET

请求参数：

参数名称	说明	in	是否必须	类型
ids	商品分类id数组	header	true	Long[]

根据搜索条件获取商品分类分页列表

接口说明:根据搜索条件获取商品分类分页列表

接口地址:/catalog/search

请求方式：POST

请求参数：

参数名称	说明	in	是否必须	类型
catalog	商品分类对象	header	false	Catalog
page	页数	header	true	int
rows	条数	header	true	int

根据商品分类id获取商品分类信息

接口说明:根据商品分类ID查询商品分类信息

接口地址:/catalog/getCatalog

请求方式：GET

请求参数：

参数名称	说明	in	是否必须	类型
id	商品分类id	header	true	Long

添加商品分类

接口说明:添加商品分类数据

接口地址:/catalog/save

请求方式：POST

请求参数：

参数名称	说明	in	是否必须	类型
catalog	商品分类对象	header	true	Catalog

更新商品分类

接口说明:更新商品分类

接口地址:/catalog/update

请求方式：POST

请求参数：

参数名称	说明	in	是否必须	类型
catalog	商品分类对象	header	true	Catalog

ApiCollectController|用户收藏管理控制器

添加收藏

接口说明:根据用户名添加收藏

接口地址:/collect/addCollect

请求方式：GET

请求参数：无

获取用户收藏的商品

接口说明:根据用户名获取该用户收藏的商品

接口地址:/collect/getCollect

请求方式：GET

请求参数：无

删除用户收藏的商品

接口说明:根据用户商品收藏ID删除该用户收藏的商品

接口地址:/collect/delete

请求方式：GET

请求参数：

参数名称	说明	in	是否必须	类型
ID	收藏ID	query	true	Long

ApiCommentController|商品评论管理控制器

添加商品评价信息

接口说明:根据商品库存ID添加商品评价信息

接口地址:/comment/save

请求方式：GET

请求参数：

参数名称	说明	in	是否必须	类型
skuID	商品库存ID	query	true	Long

获取商品评价信息

接口说明:根据商品库存ID获取商品评价信息

接口地址:/comment/getComment

请求方式：GET

请求参数：

参数名称	说明	in	是否必须	类型
skuID	商品库存ID	query	true	Long

删除商品评价信息

接口说明:根据商品库存ID删除商品评价信息

接口地址:/comment/delete

请求方式：GET

请求参数：

参数名称	说明	in	是否必须	类型
skuID	商品库存ID	query	true	Long

ApiFootprintController|用户足迹管理控制器

添加用户历史足迹

接口说明:根据用户名添加用户足迹

接口地址:/footprint/addFootprint

请求方式：GET

请求参数：无

获取用户历史足迹

接口说明:根据用户名获取该用户足迹商品

接口地址:/footprint/getFootprint

请求方式：GET

请求参数：无

删除用户历史足迹

接口说明:根据用户商品skuID删除该用户足迹商品

接口地址:/footprint/delete

请求方式：GET

请求参数：

参数名称	说明	in	是否必须	类型
skuID	商品库存ID	query	true	Long

ApiGoodsController|商品管理控制器

商品详情

接口说明:根据订单ID获取商品详情信息

接口地址:/goods/getGoods

请求方式：GET

请求参数：

参数名称	说明	in	是否必须	类型
orderID	订单ID	query	true	Long

ApiItemController|商品管理控制器

删除商品

接口说明:根据商品库存ID删除商品信息

接口地址:/item/delete

请求方式：GET

请求参数：

参数名称	说明	in	是否必须	类型
ids	商品id数组	header	true	Long[]

根据搜索条件获取商品分页列表

接口说明:根据搜索条件获取商品分页列表

接口地址:/item/search

请求方式：POST

请求参数：

参数名称	说明	in	是否必须	类型
item	商品对象	header	false	Item
page	页数	header	true	int
rows	条数	header	true	int

根据商品id获取商品信息

接口说明:根据商品库存ID查询商品信息

接口地址:/item/getItem

请求方式：GET

请求参数：

参数名称	说明	in	是否必须	类型
id	商品id	header	true	Long

添加商品

接口说明:添加商品数据

接口地址:/item/save

请求方式：POST

请求参数：

参数名称	说明	in	是否必须	类型
item	商品对象	header	true	Item
itemDesc	商品描述	header	true	String

更新商品

接口说明:更新商品信息

接口地址:/item/update

请求方式：POST

请求参数：

参数名称	说明	in	是否必须	类型
item	商品对象	header	true	Item
itemDesc	商品描述	header	true	String

ApiIndexController|首页控制器

ApiOrderController|订单管理控制器

结算后订单详情

接口说明:根据订单ID获取订单详情信息

接口地址:/order/getOrder

请求方式：POST

请求参数：

参数名称	说明	in	是否必须	类型
orderID	订单ID	query	true	Long

取消订单

接口说明:根据订单ID删除订单信息

接口地址:/order/delete

请求方式：GET

请求参数：

参数名称	说明	in	是否必须	类型
orderID	订单ID	query	true	Long

获取订单详情

接口说明:根据订单ID获取订单详情

接口地址:/order/getOrderById

请求方式：GET

请求参数：

参数名称	说明	in	是否必须	类型
orderID	订单ID	query	true	Long

ApiPayController|支付管理控制器

支付结算

接口说明:根据订单ID去支付

接口地址:/pay/pay

请求方式：GET

请求参数：

参数名称	说明	in	是否必须	类型
orderID	订单ID	query	true	Long

退款清算

接口说明:订单退款请求

接口地址:/pay/refund

请求方式：GET

请求参数：

参数名称	说明	in	是否必须	类型
orderId	订单ID	query	true	Long

ApiRegionController|地区管理控制器

ApiSearchController|搜索管理控制器

搜索关键字

接口说明:根据用户输入获取系统已有的关键字

接口地址:/search/helper

请求方式：GET

请求参数：

参数名称	说明	in	是否必须	类型
keyword	关键字	query	true	string

搜索历史记录

接口说明:获取搜索历史记录

接口地址:/search/history

请求方式：GET

请求参数：无

删除历史记录

接口说明:根据用户名删除搜索历史记录

接口地址:/search/remove

请求方式：GET

请求参数：无

ApiShelvesController|店铺管理控制器

ApiUploadController|上传管理控制器

文件上传

接口说明:上传图片信息

接口地址:/upload/uploadFile

请求方式：POST

请求参数：

参数名称	说明	in	是否必须	类型
file	要上传的文件	header	true	MultipartFile

ApiContentCategoryController|广告类型管理控制器

删除广告类型

接口说明:根据广告类型ID删除广告类型信息

接口地址:/contentCategory/delete

请求方式：GET

请求参数：

参数名称	说明	in	是否必须	类型
ids	广告类型Id数组	query	true	Long[]

根据搜索条件获取广告类型分页列表

接口说明:根据搜索条件获取广告类型分页列表

接口地址:/contentCategory/search

请求方式：POST

请求参数：

参数名称	说明	in	是否必须	类型
contentCategory	广告类型对象	header	false	ContentCategory
page	页数	header	true	int
rows	条数	header	true	int

根据广告类型id获取广告类型信息

接口说明:根据广告类型ID查询广告类型信息

接口地址:/contentCategory/getContentCategory

请求方式：GET

请求参数：

参数名称	说明	in	是否必须	类型
id	广告类型id	header	true	Long

添加广告类型

接口说明:添加广告类型数据

接口地址:/contentCategory/save

请求方式：POST

请求参数：

参数名称	说明	in	是否必须	类型
contentCategory	广告类型对象	header	true	ContentCategory

更新广告类型

接口说明:更新广告类型信息

接口地址:/contentCategory/update

请求方式：POST

请求参数：

参数名称	说明	in	是否必须	类型
contentCategory	广告类型对象	header	true	ContentCategory

ApiContentController|广告管理控制器

删除广告

接口说明:根据广告ID删除广告信息

接口地址:/content/delete

请求方式：GET

请求参数：

参数名称	说明	in	是否必须	类型
ids	广告id数组	header	true	Long[]

根据搜索条件获取广告分页列表

接口说明:根据搜索条件获取广告分页列表

接口地址:/content/search

请求方式：POST

请求参数：

参数名称	说明	in	是否必须	类型
content	广告对象	header	false	content
page	页数	header	true	int
rows	条数	header	true	int

根据广告id获取广告信息

接口说明:根据广告ID查询品牌信息

接口地址:/content/findById

请求方式：GET

请求参数：

参数名称	说明	in	是否必须	类型
id	广告id	header	true	Long

添加广告

接口说明:添加广告数据

接口地址:/content/save

请求方式：POST

请求参数：

参数名称	说明	in	是否必须	类型
content	广告对象	query	true	Content

更新广告

接口说明:更新广告信息

接口地址:/content/update

请求方式：POST

请求参数：

参数名称	说明	in	是否必须	类型
content	广告对象	header	true	Content

ApiPersonalController|个人信息控制器

用户登录

接口说明:获取用户登录信息

接口地址:/user/login

请求方式：POST

请求参数：

参数名称	说明	in	是否必须	类型
User	用户对象	body	true	User

用户注册

接口说明:保存用户信息

接口地址:/user/register

请求方式：POST

请求参数：

参数名称	说明	in	是否必须	类型
User	用户对象	body	true	User
smsCode	验证码	body	true	Integer

用户名查询

接口说明:获取用户名

接口地址:/user/getUserName

请求方式：POST

请求参数：

参数名称	说明	in	是否必须	类型
User	用户对象	body	true	User

向已绑定的手机发送验证码

接口说明:向已绑定的手机发送验证码

接口地址:/user/sendSms

请求方式：POST

请求参数：

参数名称	说明	in	是否必须	类型
phone	手机号	body	true	Integer

向用户提交的手机发送验证码

接口说明:发送验证码

接口地址:/user/sendPhoneSms

请求方式：POST

请求参数：

参数名称	说明	in	是否必须	类型
user	用户对象	body	true	User

校验验证码是否正确

接口说明:校验验证码是否正确

接口地址:/user/checkSms

请求方式：POST

请求参数：

参数名称	说明	in	是否必须	类型
smsCode	验证码	body	true	Integer
user	用户对象	body	true	User

修改用户信息

接口说明:修改用户信息

接口地址:/user/update

请求方式：POST

请求参数：

参数名称	说明	in	是否必须	类型
user	用户对象	header	true	User

ApiSpecificationController|规格管理控制器

删除规格

接口说明:根据规格ID删除规格信息

接口地址:/specification/delete

请求方式：GET

请求参数：

参数名称	说明	in	是否必须	类型
ids	规格id数组	header	true	Long[]

根据搜索条件获取规格分页列表

接口说明:根据搜索条件获取规格分页列表

接口地址:/specification/search

请求方式：POST

请求参数：

参数名称	说明	in	是否必须	类型
specification	规格对象	header	false	Specification
page	页数	header	true	int
rows	条数	header	true	int

根据规格id获取规格信息

接口说明:根据规格ID查询规格信息

接口地址:/specification/getSpecification

请求方式：GET

请求参数：

参数名称	说明	in	是否必须	类型
id	品牌id	header	true	Long

添加规格

接口说明:添加规格数据

接口地址:/specification/save

请求方式：POST

请求参数：

参数名称	说明	in	是否必须	类型
specification	规格对象	header	true	Specification

更新规格

接口说明:更新规格信息

接口地址:/specification/update

请求方式：POST

请求参数：

参数名称	说明	in	是否必须	类型
specification	规格对象	header	true	Specification