后台管理接口－商品管理模块

其他 2020-05-16 10:31:25 阅读次数: 0

上级目录：商品管理模块

  • 如果有不明白返回字段，请先查阅一下链接

PageInfo返回对象解释

具体返回字段意思参见product产品表

返回状态码

Ueditor文档

第一部分：前台门户商品管理接口

状态码：

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"}
天又热了
原创文章 243 获赞 156 访问量 2万+
关注 私信

猜你喜欢

转载自blog.csdn.net/weixin_43404791/article/details/105928755
今日推荐
TIOBE 5 月榜单：Fortran “复活”进入 Top 10
GCC 14.1 发布
面壁智能发布 Eurux-8x22B 开源大模型 —— 堪称「理科状元」
开源日报 | 谷歌扶持鸿蒙上位；开源Rabbit R1；Docker加持的安卓手机；微软的焦虑和野心；海尔电器把开放平台关了
中国码农的“35岁魔咒”
蘭雅 CorelDRAW 插件 2024.5.1 国际劳动节版，免费下载
Arc Browser for Windows 1.0 正式 GA
90后程序员开发视频搬运软件、不到一年获利超 700 万，结局很刑！
周排行
Java自定义时间格式
同步整形电路
在开发中最最最常用的字符串的属性大集合
Linux 查看端口占用并杀掉
Java基础四：ArrayList
多线程之死锁就是这么简单
mysql 基础命令集
awk 命令详解
Centos6.3编译安装nginx+php步骤
OCR （Optical Character Recognition，光学字符识别）
每日归档
更多
2024-05-08(42)
2024-05-07(14)
2024-05-06(40)
2024-05-05(0)
2024-05-04(7)
2024-05-03(19)
2024-05-02(0)
2024-05-01(4)
2024-04-30(1)
2024-04-29(40)

代码天地 © 2018 codetd.com

境外服务器   最新电视剧2022