上级目录:商品管理模块
- 如果有不明白返回字段,请先查阅一下链接
第一部分:前台门户商品管理接口
状态码:
1. 商品搜索以及动态排序List
请求路径: /product/list.do
- 请求方法:POST
- 请求参数:
categoryId 品类ID,可空
keyword 查询关键字,可空
pageNum(default=1)分页页码,可空
pageSize(default=10)每页大小,可空
orderBy (default="") 动态排序参数:基本结构{param}_{order},例如:price_desc,其中price就是字段参数,desc就是排序参数,排序两种desc和asc,可空
- 请求响应结果实例
- 响应成功
按照价格降序
{
"status": 0,
"data": {
"total": 2,//总记录数
"list": [
{
"id": 26,
"categoryId": 100002,
"name": "Apple iPhone 7 Plus (A1661) 128G 玫瑰金色 移动联通电信4G手机",
"subtitle": "iPhone 7,现更以红色呈现。",
"mainImage": "ftp://121.36.145.230/626dceb4-398e-481b-80e5-4339c3708a6e.jpg",
"price": 6999.00,
"status": 1,
"imageHost": "ftp://121.36.145.230/"
},
{
"id": 28,
"categoryId": 100012,
"name": "4+64G送手环/Huawei/华为 nova 手机P9/P10plus青春",
"subtitle": "NOVA青春版1999元",
"mainImage": "ftp://121.36.145.230/626dceb4-398e-481b-80e5-4339c3708a6e.jpg",
"price": 1999.00,
"status": 1,
"imageHost": "ftp://121.36.145.230/"
}
],
"pageNum": 1,//分页页码
"pageSize": 10,//每页大小
"size": 2,//当前页大小
"startRow": 1,//开始行
"endRow": 2,//结束行
"pages": 1,//总页数
"prePage": 0,//当前页前一页,无
"nextPage": 0,//当前页下一页,无
"isFirstPage": true,//是否是第一页
"isLastPage": true,//是否是最后一页
"hasPreviousPage": false,//是否拥有前置页
"hasNextPage": false,//是否拥有后置页
"navigatePages": 8,//导航页面,先不用管
"navigatepageNums": [//导航页面,先不用管
1
],
"navigateFirstPage": 1,//导航页面,先不用管
"navigateLastPage": 1//导航页面,先不用管
}
}
当keyword为空并且所属category品类不存在的时候
{
"status": 0,
"data": {
"total": 0,
"list": [],
"pageNum": 1,
"pageSize": 0,
"size": 0,
"startRow": 0,
"endRow": 0,
"pages": 0,
"prePage": 0,
"nextPage": 0,
"isFirstPage": true,
"isLastPage": true,
"hasPreviousPage": false,
"hasNextPage": false,
"navigatePages": 8,
"navigatepageNums": [],
"navigateFirstPage": 0,
"navigateLastPage": 0
}
}
- 响应失败
当keyword和categoryId都是空的时候
{
"status": 2,//参数不合法状态码
"msg": "ILLEGAL_ARGUMENT"//参数不合法
}
2. 获取商品详情
- 请求路径: /product/detail.do
- 请求方法:POST/GET
- 请求参数:
productId,商品ID
- 请求响应结果实例
- 响应成功
{
"status": 0,
"data": {
"id": 27,
"categoryId": 100006,
"name": null,
"subtitle": "ac3e571d-13ce-4fad-89e8-c92c2eccf536.jpeg,4bb02f1c-62d5-48cc-b358-97b05af5740d.jpeg,36bdb49c-72ae-4185-9297-78829b54b566.jpeg",
"mainImage": "ftp://121.36.145.230/626dceb4-398e-481b-80e5-4339c3708a6e.jpg",
"subImages": "ac3e571d-13ce-4fad-89e8-c92c2eccf536.jpeg,4bb02f1c-62d5-48cc-b358-97b05af5740d.jpeg,36bdb49c-72ae-4185-9297-78829b54b566.jpeg",
"detail": "<p><img alt=\"miaoshu.jpg\" src=\"http://img.happymmall.com/9c5c74e6-6615-4aa0-b1fc-c17a1eff6027.jpg\" width=\"790\" height=\"444\"><br></p><p><img alt=\"miaoshu2.jpg\" src=\"http://img.happymmall.com/31dc1a94-f354-48b8-a170-1a1a6de8751b.jpg\" width=\"790\" height=\"1441\"><img alt=\"miaoshu3.jpg\" src=\"http://img.happymmall.com/7862594b-3063-4b52-b7d4-cea980c604e0.jpg\" width=\"790\" height=\"1442\"><img alt=\"miaoshu4.jpg\" src=\"http://img.happymmall.com/9a650563-dc85-44d6-b174-d6960cfb1d6a.jpg\" width=\"790\" height=\"1441\"><br></p>",
"price": 3299.00,
"stock": 8876,
"status": null,
"createTime": "2017-04-14 07:51:54",
"updateTime": "2017-04-14 10:45:41",
"imageHost": "ftp://121.36.145.230/",
"parentCategoryId": 0
}
}
- 响应失败
{
"status": 1,
"msg": "产品已经下架或者删除"
}
第二部分:后台商品管理接口
1. 获取产品列表
- 请求路径: /manage/product/list.do
- 请求方法:POST
- 请求参数:
pageNum (default=1),当前页码,可空
pageSize(default=10)每页大小,可空
- 请求响应结果实例
- 响应成功
{
"status": 0,
"data": {
"total": 4,
"list": [
{
"id": 26,
"categoryId": 100002,
"name": "Apple iPhone 7 Plus (A1661) 128G 玫瑰金色 移动联通电信4G手机",
"subtitle": "iPhone 7,现更以红色呈现。",
"mainImage": "626dceb4-398e-481b-80e5-4339c3708a6e.jpg",
"price": 6999.00,
"status": 1,
"imageHost": "ftp://121.36.145.230/"
},
{
"id": 27,
"categoryId": 100006,
"name": "Midea/美的 BCD-535WKZM(E)冰箱双开门对开门风冷无霜智能电家用",
"subtitle": "送品牌烤箱,五一大促",
"mainImage": "626dceb4-398e-481b-80e5-4339c3708a6e.jpg",
"price": 3299.00,
"status": 1,
"imageHost": "ftp://121.36.145.230/"
},
{
"id": 28,
"categoryId": 100012,
"name": "4+64G送手环/Huawei/华为 nova 手机P9/P10plus青春",
"subtitle": "NOVA青春版1999元",
"mainImage": "626dceb4-398e-481b-80e5-4339c3708a6e.jpg",
"price": 1999.00,
"status": 1,
"imageHost": "ftp://121.36.145.230/"
},
{
"id": 29,
"categoryId": 100008,
"name": "Haier/海尔HJ100-1HU1 10公斤滚筒洗衣机全自动带烘干家用大容量 洗烘一体",
"subtitle": "门店机型 德邦送货",
"mainImage": "626dceb4-398e-481b-80e5-4339c3708a6e.jpg",
"price": 4299.00,
"status": 1,
"imageHost": "ftp://121.36.145.230/"
}
],
"pageNum": 1,
"pageSize": 10,
"size": 4,
"startRow": 1,
"endRow": 4,
"pages": 1,
"prePage": 0,
"nextPage": 0,
"isFirstPage": true,
"isLastPage": true,
"hasPreviousPage": false,
"hasNextPage": false,
"navigatePages": 8,
"navigatepageNums": [
1
],
"navigateFirstPage": 1,
"navigateLastPage": 1
}
}
- 响应失败
{
"status": 10,
"msg": "用户未登录,请登录"
}
2. 产品搜索
- 请求路径: /manage/product/search.do
- 请求方法:POST
- 请求参数:
pageNum (default=1),当前页码,可空
pageSize(default=10)每页大小,可空
productName,商品名,模糊搜索,可空
productId,商品ID,如果两个参数都加上那么与商品是并且的关系,可空
- 请求响应结果实例
http://localhost:8250/manage/product/search.do?productName=Ha - 响应成功
{
"status": 0,
"data": {
"total": 1,
"list": [
{
"id": 29,
"categoryId": 100008,
"name": "Haier/海尔HJ100-1HU1 10公斤滚筒洗衣机全自动带烘干家用大容量 洗烘一体",
"subtitle": "门店机型 德邦送货",
"mainImage": "626dceb4-398e-481b-80e5-4339c3708a6e.jpg",
"price": 4299.00,
"status": 1,
"imageHost": "ftp://121.36.145.230/"
}
],
"pageNum": 1,
"pageSize": 10,
"size": 1,
"startRow": 1,
"endRow": 1,
"pages": 1,
"prePage": 0,
"nextPage": 0,
"isFirstPage": true,
"isLastPage": true,
"hasPreviousPage": false,
"hasNextPage": false,
"navigatePages": 8,
"navigatepageNums": [
1
],
"navigateFirstPage": 1,
"navigateLastPage": 1
}
}
- 响应失败
{
"status": 10,
"msg": "用户未登录,请登录"
}
3. 图片上传
- 请求路径: /manage/product/upload.do
- 请求方法:POST
- 请求参数:
<form name="form2" action="/manage/product/upload.do" method="post" enctype="multipart/form-data">
<input type="file" name="upload_file">
<input type="submit" value="upload"/>
</form>
- 请求响应结果实例
- 响应成功
{
"status": 0,
"data": {
"uri": "d9b7416a-acf8-4d19-9405-7ce68a064716.png",
"url": "ftp://121.36.145.230/d9b7416a-acf8-4d19-9405-7ce68a064716.png"
}
}
- 响应失败
{"status":10,"msg":"用户未登录"}
{
"status": 1,
"msg": "没有权限"
}
4. 商品详情
- 请求路径: /manage/product/detail.do
- 请求方法:POST
- 请求参数:
productId,即产品ID
- 请求响应结果实例
- 响应成功
{
"status": 0,
"data": {
"id": 26,
"categoryId": 100002,
"name": null,
"subtitle": "241997c4-9e62-4824-b7f0-7425c3c28917.jpeg,b6c56eb0-1748-49a9-98dc-bcc4b9788a54.jpeg,92f17532-1527-4563-aa1d-ed01baa0f7b2.jpeg,3adbe4f7-e374-4533-aa79-cc4a98c529bf.jpeg",
"mainImage": "626dceb4-398e-481b-80e5-4339c3708a6e.jpg",
"subImages": "241997c4-9e62-4824-b7f0-7425c3c28917.jpeg,b6c56eb0-1748-49a9-98dc-bcc4b9788a54.jpeg,92f17532-1527-4563-aa1d-ed01baa0f7b2.jpeg,3adbe4f7-e374-4533-aa79-cc4a98c529bf.jpeg",
"detail": "<p><img alt=\"10000.jpg\" src=\"http://img.happymmall.com/00bce8d4-e9af-4c8d-b205-e6c75c7e252b.jpg\" width=\"790\" height=\"553\"><br></p><p><img alt=\"20000.jpg\" src=\"http://img.happymmall.com/4a70b4b4-01ee-46af-9468-31e67d0995b8.jpg\" width=\"790\" height=\"525\"><br></p><p><img alt=\"30000.jpg\" src=\"http://img.happymmall.com/0570e033-12d7-49b2-88f3-7a5d84157223.jpg\" width=\"790\" height=\"365\"><br></p><p><img alt=\"40000.jpg\" src=\"http://img.happymmall.com/50515c02-3255-44b9-a829-9e141a28c08a.jpg\" width=\"790\" height=\"525\"><br></p><p><img alt=\"50000.jpg\" src=\"http://img.happymmall.com/c138fc56-5843-4287-a029-91cf3732d034.jpg\" width=\"790\" height=\"525\"><br></p><p><img alt=\"60000.jpg\" src=\"http://img.happymmall.com/c92d1f8a-9827-453f-9d37-b10a3287e894.jpg\" width=\"790\" height=\"525\"><br></p><p><br></p><p><img alt=\"TB24p51hgFkpuFjSspnXXb4qFXa-1776456424.jpg\" src=\"http://img.happymmall.com/bb1511fc-3483-471f-80e5-c7c81fa5e1dd.jpg\" width=\"790\" height=\"375\"><br></p><p><br></p><p><img alt=\"shouhou.jpg\" src=\"http://img.happymmall.com/698e6fbe-97ea-478b-8170-008ad24030f7.jpg\" width=\"750\" height=\"150\"><br></p><p><img alt=\"999.jpg\" src=\"http://img.happymmall.com/ee276fe6-5d79-45aa-8393-ba1d210f9c89.jpg\" width=\"790\" height=\"351\"><br></p>",
"price": 6999.00,
"stock": 9991,
"status": null,
"createTime": "",
"updateTime": "2017-04-14 10:45:41",
"imageHost": "ftp://121.36.145.230/",
"parentCategoryId": 0
}
}
- 响应失败
{
"status": 1,
"msg": "没有权限"
}
{"status":10,"msg":"用户未登录"}
5. 产品上下架
- 请求路径: /manage/product/set_sale_status.do
- 请求方法:POST
- 请求参数:
productId,即产品ID
status,上下架状态,商品状态.1-在售 2-下架 3-删除- 请求响应结果实例
- 响应状态
- 响应成功
{
"status": 0,
"msg": "产品销售状态修改成功"
}
- 响应失败
{
"status": 1,
"msg": "产品销售状态修改失败"
}
6. 新增或者更新商品
- 请求路径: /manage/product/save.do
- 请求方法:POST
- 请求参数:
categoryId,所属品类ID
subtitle,副标题
mainImages,列表展示主图,地址即可
subImages,子图,列表展示,地址即可
detail,商品详情,返回地址或者富文本,现在还是富文本
price,商品价格
stock,商品库存
status,商品状态.1-在售 2-下架 3-删除- 请求响应结果实例
id,商品ID,如果是有这一个字段那就是修改,如果没有那就是新增!!!!
- 响应状态
- 响应成功
{
"status": 0,
"msg": "产品新增成功"
}
{
"status": 0,
"msg": "产品更新成功"
}
- 响应失败
{
"status": 1,
"msg": "产品更新失败"
}
7. 富文本上传图片(Ueditor图片返回格式,具体前端应该更加熟悉)
请求路径: /manage/product/richtext_img_upload.do
- 请求方法:POST
- 请求参数:
<form name="form2" action="/manage/product/upload.do" method="post" enctype="multipart/form-data">
<input type="file" name="upload_file">
<input type="submit" value="upload"/>
</form>
- 响应状态
- 响应成功
{
"status": 0,
"msg": "产品新增成功"
}
{"original":"http://www.happymmall.com/order/alipay_callback.do636c1ddf-d746-4ea2-9a36-b1436899802a.png",
"size":138363,"state":"SUCCESS",
"type":"image/png","url":"http://www.happymmall.com/order/alipay_callback.do636c1ddf-d746-4ea2-9a36-b1436899802a.png"}
- 响应失败
{"state":"ERROR"}