2017.7.14 慕课网-Java从零打造企业级电商项目实战:for4 product模块接口设计

后台接口  /manage/product

/manage/product/list.do 查询商品列表

选项

说明

URL

/list.do

功能

查询商品列表

请求方式

Get

请求参数

pageNum(default=1),pageSize(default=10)

参数说明

 

成功返回示例

{

    "status": 0,

    "data": {

        "list": [

            {

                "id": 1,

                "categoryId": 3,

                "name": "iphone7",

                "subtitle": "双十一促销",

                "mainImage": "mainimage.jpg",

                "status":1,

                "price": 7199.22

            },

            …

        ],

        "pageNum": 1,

        "pageSize": 10,

        "size": 2,

        "orderBy": null,

        "startRow": 1,

        "endRow": 2,

        "total": 2,

        "pages": 1,

        "firstPage": 1,

        "prePage": 0,

        "nextPage": 0,

        "lastPage": 1,

        "isFirstPage": true,

        "isLastPage": true,

        "hasPreviousPage": false,

        "hasNextPage": false,

        "navigatePages": 8,

        "navigatepageNums": [ 1 ]

    }

}

失败返回示例

{

    "status": 10,

    "msg": "用户未登录,请登录"

}

{

    "status":1,

    "msg": "查询商品列表失败"

}

 

/manage/product/search.do 查询某个商品

选项

说明

URL

/manage/product/search.do

功能

查询某个商品

请求方式

get

请求参数

productId,productName,pageSize(10),pageNum(1)

参数说明

productId:必填。

成功返回示例

{

    "status": 0,

    "data": {

        "list": [

            {

                "id": 1,

                "categoryId": 3,

                "name": "iphone7",

                "subtitle": "双十一促销",

                "mainImage": "mainimage.jpg",

                "price": 7199.22

            }

        ],

        "pageNum": 1,

        "pageSize": 10,

        "size": 1,

        "orderBy": null,

        "startRow": 1,

        "endRow": 1,

        "total": 1,

        "pages": 1,

        "firstPage": 1,

        "prePage": 0,

        "nextPage": 0,

        "lastPage": 1,

        "isFirstPage": true,

        "isLastPage": true,

        "hasPreviousPage": false,

        "hasNextPage": false,

        "navigatePages": 8,

        "navigatepageNums": [

            1

        ]

    }

}

失败返回示例

{

    "status": 10,

    "msg": "用户未登录,请登录"

}

{

    "status": 1,

    "msg": "查询商品失败"

}


/manage/product/detail.do 获取某个商品的详情

选项

说明

URL

/detail.do

功能

获取某个商品详情信息

请求方式

Get

请求参数

productId

参数说明

 

成功返回示例

{

    "status": 0,

    "data": {

        "id": 2,

        "categoryId": 2,

        "parentCategoryId":1,

        "name": "oppo R8",

        "subtitle": "oppo促销进行中",

        "imageHost": "http://img.happymmall.com/",

        "mainImage": "mainimage.jpg",

        "subImages": "[\"mmall/aa.jpg\",\"mmall/bb.jpg\",\"mmall/cc.jpg\",\"mmall/dd.jpg\",\"mmall/ee.jpg\"]",

        "detail": "richtext",

        "price": 2999.11,

        "stock": 71,

        "status": 1,

        "createTime": "2016-11-20 14:21:53",

        "updateTime": "2016-11-20 14:21:53"

    }

}

失败返回示例

{

    "status": 10,

    "msg": "用户未登录,请登录"

}

{

    "status": 1,

    "msg": "查询商品详情失败"

}

 

/manage/product/set_sale_status.do 商品上下架

选项

说明

URL

/set_sale_status.do

功能

商品上下架

请求方式

Put

请求参数

productId,status

参数说明

productId:必填。

status:必填,=1上架,=0下架。

成功返回示例

{

    "status": 0,

    "data": "修改商品状态成功"

}

失败返回示例

{

    "status": 10,

    "msg": "用户未登录,请登录"

}

{

    "status": 1,

    "msg": "修改商品状态失败"

}

 

/manage/product/save.do 新增或更新商品

选项

说明

URL

/manage/product/save.do

功能

新增或更新商品

请求方式

Put/post

请求参数

categoryId,name,subtitle,mainImage,subImage,detail,price,stock,status,id

参数说明

id:有值时为更新,无值时为新增。

成功返回示例

{

    "status": 0,

    "data": "更新/新增产品成功"

}

失败返回示例

{

    "status": 10,

    "msg": "用户未登录,请登录"

}

{

    "status": 1,

    "msg": "新增/更新商品失败"

}

 

/manage/product/upload.do 图片上传

选项

说明

URL

/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": "***.jpg",

        "url":"http://img.happymmall.com/***.jpg"

    }

}

失败返回示例

{

    "status": 10,

    "msg": "用户未登录,请登录"

}

{

    "status": 1,

    "msg": "上传失败"

}

 

/manage/product/richtext_img_upload.do 富文本上传图片

选项

说明

URL

/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>

参数说明

 

成功返回示例

{

    "file_path": "http://img.happymmall.com/**.jpg",

    "msg": "上传成功",

    "status": 0

}

失败返回示例

{

    "status": 10,

    "msg": "用户未登录,请登录"

}

{

    "status": 1,

    "msg": "error message",

    "file_path": "[real file path]"

}

 


 

 

阅读更多
版权声明:本文为博主原创文章,未经博主允许不得转载。 https://blog.csdn.net/liyuhui195134/article/details/78972714
想对作者说点什么? 我来说一句

没有更多推荐了,返回首页

加入CSDN,享受更精准的内容推荐,与500万程序员共同成长!
关闭
关闭