技术文档_小U商城后台管理系统_web实训项目

接口清单

接口名称	调用地址	调用方式	实现方式
菜单添加	/api/menuadd	POST	Express
菜单列表	/api/menulist	GET	Express
菜单获取（一条）	/api/menuinfo	GET	Express
菜单修改	/api/menuedit	POST	Express
菜单删除	/api/menudelete	POST	Express
角色添加	/api/roleadd	POST	Express
角色列表	/api/rolelist	GET	Express
角色获取（一条）	/api/roleinfo	GET	Express
角色修改	/api/roleedit	POST	Express
角色删除	/api/roledelete	POST	Express
管理员添加	/api/useradd	POST	Express
.管理员总数（用于计算分页）	/api/usercount	GET	Express
管理员列表（分页）	/api/userlist	GET	Express
管理员获取（一条）	/api/userinfo	GET	Express
管理员修改	/api/useredit	POST	Express
管理员删除	/api/userdelete	POST	Express
管理员登录	/api/userlogin	POST	Express
商品分类添加	/api/cateadd	POST	Express
商品分类列表	/api/catelist	GET	Express
商品分类获取（一条）	/api/cateinfo	GET	Express
商品分类修改	/api/cateedit	POST	Express
商品分类删除	/api/catedelete	POST	Express
商品规格添加	/api/specsadd	POST	Express
商品规格总数（用于计算分页）	/api/specscount	GET	Express
商品规格列表（分页）	/api/specslist	GET	Express
商品规格获取（一条）	/api/specsinfo	GET	Express
商品规格修改	/api/specsedit	POST	Express
商品规格删除	/api/specsdelete	POST	Express
商品添加	/api/goodsadd	POST	Express
商品总数（用于计算分页）	/api/goodscount	GET	Express
商品列表（分页）	/api/goodslist	GET	Express
商品获取（一条）	/api/goodsinfo	GET	Express
商品修改	/api/goodsedit	POST	Express
商品删除	/api/goodsdelete	POST	Express
会员列表	/api/memberlist	GET	Express
会员获取（一条）	/api/memberinfo	GET	Express
会员修改	/api/memberedit	POST	Express
轮播图添加	/api/banneradd	POST	Express
轮播图列表	/api/bannerlist	GET	Express
轮播图获取（一条）	/api/bannerinfo	GET	Express
轮播图修改	/api/banneredit	POST	Express
轮播图删除	/api/bannerdelete	GET	Express
限时秒杀添加	/api/seckadd	POST	Express
限时秒杀列表	/api/secklist	GET	Express
限时秒杀获取（一条）	/api/seckinfo	GET	Express
限时秒杀修改	/api/seckedit	POST	Express
限时秒杀删除	/api/seckdelete	POST	Express

调用流程

推荐使用axios请求接口。

配置代理

由于采用了前端分离的开发模式，前后端分别部署到不同的服务器会端口，产生跨域的问题。在开发环境下，服务器启动成功后，默认端口为3000，客户端默认端口为8080。可以在vue中配置代理，解决开发环境下的跨域问题。

修改/config/index.js文件，把其中的proxyTable配置选项改为：

proxyTable: {
      '/api': {
        target: 'http://localhost:3000'//目标域名地址
      },
      '/uploads': {
        target: 'http://localhost:3000'
      }
    },

token

管理员登录成功后，会返回token，在请求其他接口的时候，需要在请求头中携带token，可以使用拦截器拦截请求，把token注入到请求头的Authorization上：

axios.interceptors.request.use(function (config) {
  // Do something before request is sent  Authorization
  config.headers = {
    //从store中获取token
    Authorization:store.state.adminUser.token,
  }
  return config;
}, function (error) {
  // Do something with request error
  return Promise.reject(error);
});

请求示例

请求商品列表接口

url: /api/goodslist

请求头：
Authorization: eyJzZWMiOiJSU0EiLCJ0eXBlIjoiSldUIn0=.eyJuYmYiOjE1OTY3MTQyMTI1OTcsInVpZCI6IjgwNjM1ZjEwLWQwMTgtMTFlYS1hMDQ5LTViNjY4OGQ1NmJkNCIsImxhc3RUaW1lIjozNjAwMDAwfQ==.Yi6h62M7RYVoYA8xYJ2ytHW/4mjiyPx/kluEYxKXS4CarnTRjtfaJT3Lctrh+cvkYmOoyHWHULfqR0WDPH28PM9792k5rCMvQ60QUuCc3aeEds7A+0a8OStBzxvLmjUIdPq1fiukFfnWW3M8OnbQTArvTxN3HzfmEIHIQ3/ybsR7N8ubtlI5GYVzHMhK55LSeM+6Hl4coBH+n7izE743RO54rzzBWjz8bqvq2P6r0ZLQojlmBfJgjZTJqI1gR5BH52b9/NxBczJqltMCnN4p6S8mS9c/LwyfP1gcBhPqFuZrmFpTArt4ldLF/WZC1uG0B0e9t2fUZQQHfvrYO+QWHQ==

请求参数：
{
  size: 10,
  page: 1
}
响应数据：
{
    "msg": "操作成功",
    "code": 200,
    "list": [
    {
        "id": 1,
        "first_cateid": 2,
        "second_cateid": 10,
        "goodsname": "小米10",
        "price": 3999,
        "market_price": 3999,
        "img": "/uploads/fa5c2790-6c48-11ea-b894-9bd516f4e52e.jpg",
        "description": "<p>11</p><p>22</p><p>33</p>",
        "specsid": 3,
        "specsattr": "白色,黑色",
        "isnew": 0,
        "ishot": 1,
        "status": 1,
        "firstcatename": "手机通讯",
        "secondcatename": "手机"
        }
    ]
}

示例代码：

this.$axios
        .get(this.$apis.goodslist, {params:{ size: 10, page: 1 }})
        .then(result => {
          console.log(this.goodslist);
        })
        .catch(err => {});

菜单管理

说明

菜单管理一共包括：菜单添加、菜单列表、菜单获取、菜单修改、菜单删除，五个功能，负责项目的菜单管理

菜单添加

接口功能

菜单添加

URL

/api/menuadd

HTTP请求方式

POST

请求参数

参数名称	描述
pid	上级分类编号
title	标题
icon	图标
type	类型1目录2菜单
url	菜单地址
status	状态1正常2禁用

返回数据

数据格式

{
  "msg": "添加成功",
  "code": 200,
  "list": []
}

状态码	描述
200	成功
403	参数正确，但是权限不够
500	参数错误，请检查传递的参数

举例

请求报文：
{
  icon: ""
  pid: 8
  status: 1
  title: "aa"
  type: 2
  url: ""
}
响应报文
{
  "msg": "添加成功",
  "code": 200,
  "list": []
}

菜单列表

接口功能

菜单列表

URL

/api/menulist

HTTP请求方式

GET

请求参数

参数名称	描述
istree	是否是树形结构数据，默认值：1

返回数据

数据格式

{
    "msg": "操作成功",
    "code": 200,
    "list": [
        {
        "id": 1,
        "pid": 0,
        "title": "系统设置",
        "icon": "el-icon-setting",
        "type": 1,
        "url": "",
        "status": 1,
        "children": [
            {
                "id": 2,
                "pid": 1,
                "title": "菜单管理",
                "icon": "",
                "type": 2,
                "url": "/menu",
                "status": 1
            },
            ]
        },
    ]
}

状态码	描述
200	成功
403	参数正确，但是权限不够
500	参数错误，请检查传递的参数

举例

请求报文：
{
 istree:1
}
响应报文
{
    "msg": "操作成功",
    "code": 200,
    "list": [
        {
        "id": 1,
        "pid": 0,
        "title": "系统设置",
        "icon": "el-icon-setting",
        "type": 1,
        "url": "",
        "status": 1,
        "children": [
            {
                "id": 2,
                "pid": 1,
                "title": "菜单管理",
                "icon": "",
                "type": 2,
                "url": "/menu",
                "status": 1
            },
            ]
        },
    ]
}

菜单获取（一条）

接口功能

菜单获取（一条）

URL

/api/menuinfo

HTTP请求方式

GET

请求参数

参数名称	描述
id	菜单编号

返回数据

数据格式

{
    "msg": "获取成功",
    "code": 200,
    "list": {
        "pid": 0,
        "title": "系统设置",
        "icon": "el-icon-setting",
        "type": 1,
        "url": "",
        "status": 1
      }
}

状态码	描述
200	成功
403	参数正确，但是权限不够
500	参数错误，请检查传递的参数

举例

请求报文：
{
 id:1
}
响应报文
{
    "msg": "获取成功",
    "code": 200,
    "list": {
        "pid": 0,
        "title": "系统设置",
        "icon": "el-icon-setting",
        "type": 1,
        "url": "",
        "status": 1
      }
}

菜单修改

接口功能

菜单修改

URL

/api/menuedit

HTTP请求方式

POST

请求参数

参数名称	描述
id	编号，必填项
pid	上级分类编号
title	标题
icon	图标
type	类型1目录2菜单
url	菜单地址
status	状态1正常2禁用

返回数据

数据格式

{
  "msg": "操作成功",
  "code": 200,
  "list": []
}

状态码	描述
200	成功
403	参数正确，但是权限不够
500	参数错误，请检查传递的参数

举例

请求报文：
{
   icon: ""
   id: "18"
   pid: 17
   status: 1
   title: "入库管理"
   type: 2
   url: "/ruku11"
}
响应报文
{
  "msg": "操作成功",
  "code": 200,
  "list": []
}

菜单删除

接口功能

菜单删除

URL

/api/menudelete

HTTP请求方式

POST

请求参数

参数名称	描述
id	编号，必填项

返回数据

数据格式

{
  "msg": "操作成功",
  "code": 200,
  "list": []
}

状态码	描述
200	成功
403	参数正确，但是权限不够
500	参数错误，请检查传递的参数

举例

请求报文：
{
   id: "18"
}
响应报文
{
    "msg": "操作成功",
    "code": 200,
    "list": [
        {
        "id": 1,
        "pid": 0,
        "title": "系统设置",
        "icon": "el-icon-setting",
        "type": 1,
        "url": "",
        "status": 1,
        "children": [
            {
                "id": 2,
                "pid": 1,
                "title": "菜单管理",
                "icon": "",
                "type": 2,
                "url": "/menu",
                "status": 1
            },
            ]
        },
    ]
}

角色管理

说明

角色管理一共包括：角色添加、角色列表、角色获取、角色修改、角色删除，五个功能，负责项目的角色管理

角色添加

接口功能

角色添加

URL

/api/roleadd

HTTP请求方式

POST

请求参数

参数名称	描述
rolename	角色名称 string
menus	角色权限 string : 2,3,4
status	状态1正常2禁用

返回数据

数据格式

{
  "msg": "操作成功",
  "code": 200,
  "list": "添加成功"
}

状态码	描述
200	成功
403	参数正确，但是权限不够
500	参数错误，请检查传递的参数

举例

请求报文：
{
  menus: "1,2,3,7"
  rolename: "aa"
  status: 1
}
响应报文
{
  "msg": "操作成功",
  "code": 200,
  "list": "添加成功"
}

角色列表

接口功能

角色列表

URL

/api/rolelist

HTTP请求方式

GET

请求参数

参数名称	描述
无	-

返回数据

数据格式

{
    "msg": "操作成功",
    "code": 200,
    "list": [
        {
            "id": 3,
            "rolename": "系统管理员",
            "menus": "1,2,3,7,8,9,10,11,12,14,20,17,18,19",
            "status": 1
        },
        {
            "id": 9,
            "rolename": "普通管理员",
            "menus": "1,2,8,9,10,11,12,14,15,17,18,19",
            "status": 1
        },
    ]
}

状态码	描述
200	成功
403	参数正确，但是权限不够
500	参数错误，请检查传递的参数

举例

请求报文：

响应报文
{
    "msg": "操作成功",
    "code": 200,
    "list": [
        {
            "id": 3,
            "rolename": "系统管理员",
            "menus": "1,2,3,7,8,9,10,11,12,14,20,17,18,19",
            "status": 1
        },
        {
            "id": 9,
            "rolename": "普通管理员",
            "menus": "1,2,8,9,10,11,12,14,15,17,18,19",
            "status": 1
        },
    ]
}

角色获取（一条）

接口功能

角色获取

URL

/api/roleinfo

HTTP请求方式

GET

请求参数

参数名称	描述
id	角色编号

返回数据

数据格式

{
    "msg": "获取成功",
    "code": 200,
    "list": {
        "rolename": "系统管理员",
        "menus": "1,2,3,7,8,9,10,11,12,14,20,17,18,19",
        "status": 1
    }
}

状态码	描述
200	成功
403	参数正确，但是权限不够
500	参数错误，请检查传递的参数

举例

请求报文：
{
 id:3
}
响应报文
{
    "msg": "获取成功",
    "code": 200,
    "list": {
        "rolename": "系统管理员",
        "menus": "1,2,3,7,8,9,10,11,12,14,20,17,18,19",
        "status": 1
    }
}

角色修改

接口功能

角色修改

URL

/api/roleedit

HTTP请求方式

POST

请求参数

参数名称	描述
id	角色编号
rolename	角色名称
menus	角色权限
status	状态1正常2禁用

返回数据

数据格式

{
  "msg": "操作成功",
  "code": 200,
  "list": []
}

状态码	描述
200	成功
403	参数正确，但是权限不够
500	参数错误，请检查传递的参数

举例

请求报文：
{
  id: "3"
  menus: "1,2,3,7,8,9,10,11,12,14,20"
  rolename: "系统管理员"
  status: 1
}
响应报文
{
  "msg": "操作成功",
  "code": 200,
  "list": []
}

角色删除

接口功能

角色删除

URL

/api/roledelete

HTTP请求方式

POST

请求参数

参数名称	描述
id	角色编号

返回数据

数据格式

{
    "msg": "操作成功",
    "code": 200,
    "list": [
    {
      "id": 3,
      "rolename": "系统管理员",
      "menus": "1,2,3,7,8,9,10,11,12,14,20",
      "status": 1
      },
    ]
}

状态码	描述
200	成功
403	参数正确，但是权限不够
500	参数错误，请检查传递的参数

举例

请求报文：
{
  id: "3"
}
响应报文
{
    "msg": "操作成功",
    "code": 200,
    "list": [
    {
      "id": 3,
      "rolename": "系统管理员",
      "menus": "1,2,3,7,8,9,10,11,12,14,20",
      "status": 1
      },
    ]
}

管理员管理

说明

管理员管理一共包括：管理员添加、管理员总数、管理员列表、管理员获取、管理员修改、管理员删除、管理员登录，共七个功能，负责项目的管理员管理

管理员添加

接口功能

管理员添加

URL

/api/useradd

HTTP请求方式

POST

请求参数

参数名称	描述
roleid	角色编号
username	管理员名称
password	密码
status	状态1正常2禁用

返回数据

数据格式

{
  "msg": "添加成功",
  "code": 200,
  "list": []
}

状态码	描述
200	成功
403	参数正确，但是权限不够
500	参数错误，请检查传递的参数

举例

请求报文：
{
  password: "123"
  roleid: 10
  status: 1
  uid: ""
  username: "test"
}
响应报文
{
  "msg": "添加成功",
  "code": 200,
  "list": []
}

管理员总数（用于计算分页）

接口功能

管理员添加

URL

/api/usercount

HTTP请求方式

GET

请求参数

参数名称	描述
无	-

返回数据

数据格式

{
  "msg": "操作成功",
  "code": 200,
  "list": [
    {
    	"total": 6
    }
  ]
}

状态码	描述
200	成功
403	参数正确，但是权限不够
500	参数错误，请检查传递的参数

举例

请求报文：

响应报文
{
  "msg": "操作成功",
  "code": 200,
  "list": [
    {
    	"total": 6
    }
  ]
}

管理员列表（分页）

接口功能

管理员列表（分页）

URL

/api/userlist

HTTP请求方式

GET

请求参数

参数名称	描述
size	查询条数
page	页码数

返回数据

数据格式

{
  "msg": "操作成功",
  "code": 200,
  "list": [
    {
      "id": 1,
      "uid": "7f412140-6b72-11ea-a476-bbdc6fb709e3",
      "roleid": 3,
      "username": "admin",
      "password": "904793bd8f8b17435798173c6af24eff",
      "randstr": "LFLK8",
      "status": 1,
      "rolename": "系统管理员"
    },
  ]
}

状态码	描述
200	成功
403	参数正确，但是权限不够
500	参数错误，请检查传递的参数

举例

请求报文：
{
size:1,
page:1
}
响应报文
{
  "msg": "操作成功",
  "code": 200,
  "list": [
    {
      "id": 1,
      "uid": "7f412140-6b72-11ea-a476-bbdc6fb709e3",
      "roleid": 3,
      "username": "admin",
      "password": "904793bd8f8b17435798173c6af24eff",
      "randstr": "LFLK8",
      "status": 1,
      "rolename": "系统管理员"
    },
  ]
}

管理员获取（一条）

接口功能

管理员获取（一条）

URL

/api/userinfo

HTTP请求方式

GET

请求参数

参数名称	描述
uid	用户编号【唯一编号，不是主键】

返回数据

数据格式

{
  "msg": "获取成功",
  "code": 200,
  "list": {
    "uid": "00104e40-ea85-11ea-9d28-59be208caecc",
    "roleid": 3,
    "username": "abc",
    "password": "2301d7084336c3505be3f19941c4c1c5",
    "randstr": "H4g2x",
    "status": 1
    }
}

状态码	描述
200	成功
403	参数正确，但是权限不够
500	参数错误，请检查传递的参数

举例

请求报文：
{
	uid: 00104e40-ea85-11ea-9d28-59be208caecc
}
响应报文
{
  "msg": "获取成功",
  "code": 200,
  "list": {
    "uid": "00104e40-ea85-11ea-9d28-59be208caecc",
    "roleid": 3,
    "username": "abc",
    "password": "2301d7084336c3505be3f19941c4c1c5",
    "randstr": "H4g2x",
    "status": 1
    }
}

管理员修改

接口功能

管理员修改

URL

/api/useredit

HTTP请求方式

POST

请求参数

参数名称	描述
uid	用户编号，必填项
roleid	角色编号
username	管理员名称
password	密码
status	状态1正常2禁用

返回数据

数据格式

{
  "msg": "操作成功",
  "code": 200,
  "list": []
}

状态码	描述
200	成功
403	参数正确，但是权限不够
500	参数错误，请检查传递的参数

举例

请求报文：
{
	uid: 00104e40-ea85-11ea-9d28-59be208caecc
}
响应报文
{
  "msg": "操作成功",
  "code": 200,
  "list": []
}

管理员删除

接口功能

管理员删除

URL

/api/userdelete

HTTP请求方式

POST

请求参数

参数名称	描述
uid	用户编号，必填项

返回数据

数据格式

{
  "msg": "操作成功",
  "code": 200,
  "list": [
    {
      "id": 1,
      "uid": "7f412140-6b72-11ea-a476-bbdc6fb709e3",
      "roleid": 3,
      "username": "admin",
      "password": "904793bd8f8b17435798173c6af24eff",
      "randstr": "LFLK8",
      "status": 1,
      "rolename": "系统管理员"
    },
  ]
}

状态码	描述
200	成功
403	参数正确，但是权限不够
500	参数错误，请检查传递的参数

举例

请求报文：
{
	uid: 00104e40-ea85-11ea-9d28-59be208caecc
}
响应报文
{
  "msg": "操作成功",
  "code": 200,
  "list": [
    {
      "id": 1,
      "uid": "7f412140-6b72-11ea-a476-bbdc6fb709e3",
      "roleid": 3,
      "username": "admin",
      "password": "904793bd8f8b17435798173c6af24eff",
      "randstr": "LFLK8",
      "status": 1,
      "rolename": "系统管理员"
    },
  ]
}

管理员登录

接口功能

管理员登录

URL

/api/userlogin

HTTP请求方式

POST

请求参数

参数名称	描述
username	用户名
password	密码

返回数据

数据格式

{
  "msg": "登录成功",
  "code": 200,
  "list": {
      "id": 6,
      "uid": "80635f10-d018-11ea-a049-5b6688d56bd4",
      "roleid": 3,
      "username": "davie",
      "status": 1,
      "menus_url": [
        "/menu",
        "/role",
        "/user",
        "/cate",
        "/specs",
        "/goods",
        "/member",
        "/banner",
        "/seckill"
        ],
      "menus": [
          {
              "id": 1,
              "pid": 0,
              "title": "系统设置",
              "icon": "el-icon-setting",
              "type": 1,
              "url": "",
              "status": 1,
              "children": []
          },
          {
              "id": 8,
              "pid": 0,
              "title": "商城管理",
              "icon": "el-icon-s-goods",
              "type": 1,
              "url": "",
              "status": 1,
              "children": [
                  {
                      "id": 9,
                      "pid": 8,
                      "title": "商品分类",
                      "icon": "",
                      "type": 2,
                      "url": "/cate",
                      "status": 1
                  },
              ]
          }
          ],
      "token": "eyJzZWMiOiJSU0EiLCJ0eXBlIjoiSldUIn0=.eyJuYmYiOjE1OTkwMzE4OTQyODcsInVpZCI6IjgwNjM1ZjEwLWQwMTgtMTFlYS1hMDQ5LTViNjY4OGQ1NmJkNCIsImxhc3RUaW1lIjozNjAwMDAwfQ==.T0laDLhArI8ffvP2ilnEQj09x9rw2j+SIcCUbjyMjREYlibgxxHzLWO8XpMxDHUDzu2mEG9vPCVlnm5DLpwO4wLH59N29eGHNtol5Gr8tTxWhZ/TGFgDaAnZIjvb0euz+3jpz3UPdU4Qb534K0S2EKvHVFaDl0J4yHY4+uXdLBQ5G5H1ziugpEErZ9b3uY7Lg/CvIcNo+BGSd0Xaa9n/etHW52SG5ranRvz3ouIxnoTO73xQIJ18lNFBJJ6TMfYWIQSoKdxnD+1KkX78WTXXF/B1JkxcB/mJp75LqbRKKvjqqoWryl6Qy/nIxpz0VQmsAQa+dVf9Lpy4x7LrmG7b3A=="
  }
}

状态码	描述
200	成功
403	参数正确，但是权限不够
500	参数错误，请检查传递的参数

举例

请求报文：
{
	password: "admin"
	username: "admin"
}
响应报文
{
  "msg": "登录成功",
  "code": 200,
  "list": {
      "id": 6,
      "uid": "80635f10-d018-11ea-a049-5b6688d56bd4",
      "roleid": 3,
      "username": "davie",
      "status": 1,
      "menus_url": [
        "/menu",
        "/role",
        "/user",
        "/cate",
        "/specs",
        "/goods",
        "/member",
        "/banner",
        "/seckill"
        ],
      "menus": [
          {
              "id": 1,
              "pid": 0,
              "title": "系统设置",
              "icon": "el-icon-setting",
              "type": 1,
              "url": "",
              "status": 1,
              "children": []
          },
          {
              "id": 8,
              "pid": 0,
              "title": "商城管理",
              "icon": "el-icon-s-goods",
              "type": 1,
              "url": "",
              "status": 1,
              "children": [
                  {
                      "id": 9,
                      "pid": 8,
                      "title": "商品分类",
                      "icon": "",
                      "type": 2,
                      "url": "/cate",
                      "status": 1
                  },
              ]
          }
          ],
      "token": "eyJzZWMiOiJSU0EiLCJ0eXBlIjoiSldUIn0=.eyJuYmYiOjE1OTkwMzE4OTQyODcsInVpZCI6IjgwNjM1ZjEwLWQwMTgtMTFlYS1hMDQ5LTViNjY4OGQ1NmJkNCIsImxhc3RUaW1lIjozNjAwMDAwfQ==.T0laDLhArI8ffvP2ilnEQj09x9rw2j+SIcCUbjyMjREYlibgxxHzLWO8XpMxDHUDzu2mEG9vPCVlnm5DLpwO4wLH59N29eGHNtol5Gr8tTxWhZ/TGFgDaAnZIjvb0euz+3jpz3UPdU4Qb534K0S2EKvHVFaDl0J4yHY4+uXdLBQ5G5H1ziugpEErZ9b3uY7Lg/CvIcNo+BGSd0Xaa9n/etHW52SG5ranRvz3ouIxnoTO73xQIJ18lNFBJJ6TMfYWIQSoKdxnD+1KkX78WTXXF/B1JkxcB/mJp75LqbRKKvjqqoWryl6Qy/nIxpz0VQmsAQa+dVf9Lpy4x7LrmG7b3A=="
  }
}

商品分类管理

说明

商品分类管理一共包括：商品分类添加、商品分类列表、商品分类获取、商品分类修改、商品分类删除，共五个功能，负责商品分类的管理

商品分类添加

接口功能

商品分类添加

URL

/api/cateadd

HTTP请求方式

POST

请求参数

参数名称	描述
pid	上级分类编号
catename	商品分类名称
img	图片(文件，一般用于二级分类)
status	状态1正常2禁用

返回数据

数据格式

{
  "msg": "添加成功",
  "code": 200,
  "list": []
}

状态码	描述
200	成功
403	参数正确，但是权限不够
500	参数错误，请检查传递的参数

举例

请求报文：
{
  pid: 0
  catename: aaa
  status: 1
  img:
}
响应报文
{
  "msg": "添加成功",
  "code": 200,
  "list": []
}

商品分类获取（一条）

接口功能

商品分类获取（一条）

URL

/api/cateinfo

HTTP请求方式

GET

请求参数

参数名称	描述
id	分类编号

返回数据

数据格式

{
  "msg": "获取成功",
  "code": 200,
  "list": {
    "pid": 0,
    "catename": "aaa1",
    "img": "",
    "status": 1
  }
}

状态码	描述
200	成功
403	参数正确，但是权限不够
500	参数错误，请检查传递的参数

举例

请求报文：
{
 id:21
}
响应报文
{
  "msg": "获取成功",
  "code": 200,
  "list": {
    "pid": 0,
    "catename": "aaa1",
    "img": "",
    "status": 1
  }
}

商品分类修改

接口功能

商品分类修改

URL

/api/cateedit

HTTP请求方式

POST

请求参数

参数名称	描述
id	分类编号，必填项
pid	上级分类编号
catename	商品分类名称
img	图片(一般用于二级分类)
status	状态1正常2禁用

返回数据

数据格式

{
"msg": "操作成功",
"code": 200,
"list": []
}

状态码	描述
200	成功
403	参数正确，但是权限不够
500	参数错误，请检查传递的参数

举例

请求头：
Content-Type: multipart/form-data;

请求报文：
{
  pid: 0
  catename: aaa1
  img: 
  status: 1
  id: 21
  img: 
}
响应报文
{
"msg": "操作成功",
"code": 200,
"list": []
}

商品分类列表

接口功能

商品分类列表

URL

/api/catelist

HTTP请求方式

GET

请求参数

参数名称	描述
无	-

返回数据

数据格式

{
    "msg": "操作成功",
    "code": 200,
    "list": [
        {
        "id": 1,
        "pid": 0,
        "catename": "家用电器",
        "img": "",
        "status": 1,
        "children": [
            {
                "id": 7,
                "pid": 1,
                "catename": "电视",
                "img": "/uploads/category/fc3abc50-6c2c-11ea-b86c-579aced212c2.jpg",
                "status": 1
            },
            ]
        },
    ]
}

状态码	描述
200	成功
403	参数正确，但是权限不够
500	参数错误，请检查传递的参数

举例

请求头：

请求报文：

响应报文
{
    "msg": "操作成功",
    "code": 200,
    "list": [
        {
        "id": 1,
        "pid": 0,
        "catename": "家用电器",
        "img": "",
        "status": 1,
        "children": [
            {
                "id": 7,
                "pid": 1,
                "catename": "电视",
                "img": "/uploads/category/fc3abc50-6c2c-11ea-b86c-579aced212c2.jpg",
                "status": 1
            },
            ]
        },
    ]
}

商品分类删除

接口功能

商品分类删除

URL

/api/catedelete

HTTP请求方式

POST

请求参数

参数名称	描述
id	分类编号

返回数据

数据格式

{
    "msg": "操作成功",
    "code": 200,
    "list": [
        {
        "id": 1,
        "pid": 0,
        "catename": "家用电器",
        "img": "",
        "status": 1,
        "children": [
            {
                "id": 7,
                "pid": 1,
                "catename": "电视",
                "img": "/uploads/category/fc3abc50-6c2c-11ea-b86c-579aced212c2.jpg",
                "status": 1
            },
            ]
        },
    ]
}

状态码	描述
200	成功
403	参数正确，但是权限不够
500	参数错误，请检查传递的参数

举例

请求头：

请求报文：
{
	id:21
}
响应报文
{
    "msg": "操作成功",
    "code": 200,
    "list": [
        {
        "id": 1,
        "pid": 0,
        "catename": "家用电器",
        "img": "",
        "status": 1,
        "children": [
            {
                "id": 7,
                "pid": 1,
                "catename": "电视",
                "img": "/uploads/category/fc3abc50-6c2c-11ea-b86c-579aced212c2.jpg",
                "status": 1
            },
            ]
        },
    ]
}

商品规格管理

说明

商品规格管理一共包括：商品规格添加、商品规格总数、商品规格列表、商品规格获取、商品规格修改、商品规格删除，共六个功能，负责商品规格的管理

商品规格添加

接口功能

商品规格添加

URL

/api/specsadd

HTTP请求方式

POST

请求参数

参数名称	描述
specsname	商品规格名称
attrs	商品规格属性值
status	状态1正常2禁用

返回数据

数据格式

{
  "msg": "添加成功",
  "code": 200,
  "list": []
}

状态码	描述
200	成功
403	参数正确，但是权限不够
500	参数错误，请检查传递的参数

举例

请求报文：
{
  attrs: "11"
  specsname: "aa"
  status: 1
}
响应报文
{
  "msg": "添加成功",
  "code": 200,
  "list": []
}

商品规格总数（用于计算分页）

接口功能

商品规格总数（用于计算分页）

URL

/api/specscount

HTTP请求方式

GET

请求参数

参数名称	描述
无	-

返回数据

数据格式

{
    "msg": "操作成功",
    "code": 200,
    "list": [
        {
        		"total": 4
        }
    ]
}

状态码	描述
200	成功
403	参数正确，但是权限不够
500	参数错误，请检查传递的参数

举例

请求报文：

响应报文
{
    "msg": "操作成功",
    "code": 200,
    "list": [
        {
        		"total": 4
        }
    ]
}

商品规格获取（一条）

接口功能

商品规格获取（一条）

URL

/api/specsinfo

HTTP请求方式

GET

请求参数

参数名称	描述
id	规格编号

返回数据

数据格式

{
  "msg": "获取成功",
  "code": 200,
  "list": [
      {
        "id": 3,
        "specsname": "颜色",
        "status": 1,
        "attrs": [
          "白色",
          "黑色"
        ]
      }
  ]
}

状态码	描述
200	成功
403	参数正确，但是权限不够
500	参数错误，请检查传递的参数

举例

请求报文：
{
	id: 3
}
响应报文
{
  "msg": "获取成功",
  "code": 200,
  "list": [
      {
        "id": 3,
        "specsname": "颜色",
        "status": 1,
        "attrs": [
          "白色",
          "黑色"
        ]
      }
  ]
}

商品规格修改

接口功能

商品规格修改

URL

/api/specsedit

HTTP请求方式

POST

请求参数

参数名称	描述
id	分类编号，必填项
specsname	商品规格名称
attrs	商品规格属性值
status	状态1正常2禁用

返回数据

数据格式

{
  "msg": "操作成功",
  "code": 200,
  "list": []
}

状态码	描述
200	成功
403	参数正确，但是权限不够
500	参数错误，请检查传递的参数

举例

请求报文：
{
	attrs: "白色,黑色1"
  id: "3"
  specsname: "颜色"
  status: 1
}
响应报文
{
  "msg": "操作成功",
  "code": 200,
  "list": []
}

商品规格列表

接口功能

商品规格列表

URL

/api/specslist

HTTP请求方式

GET

请求参数

参数名称	描述
size	查询条数
page	页码数

返回数据

数据格式

{
    "msg": "操作成功",
    "code": 200,
    "list": [
      {
      "id": 3,
      "specsname": "颜色",
      "status": 1,
      "attrs": [
          "白色",
          "黑色1"
        ]
      },
    ]
}

状态码	描述
200	成功
403	参数正确，但是权限不够
500	参数错误，请检查传递的参数

举例

请求报文：
{
  size: 10
  page: 1
}
响应报文
{
    "msg": "操作成功",
    "code": 200,
    "list": [
      {
      "id": 3,
      "specsname": "颜色",
      "status": 1,
      "attrs": [
          "白色",
          "黑色1"
        ]
      },
    ]
}

商品规格删除

接口功能

商品规格删除

URL

/api/specsdelete

HTTP请求方式

POST

请求参数

参数名称	描述
id	规格编号

返回数据

数据格式

{
    "msg": "操作成功",
    "code": 200,
    "list": [
        {
        "id": 3,
        "specsname": "颜色",
        "status": 1,
        "attrs": [
            "白色",
            "黑色1"
          ]
        },
    ]
}

状态码	描述
200	成功
403	参数正确，但是权限不够
500	参数错误，请检查传递的参数

举例

请求报文
{
	id: 7
}
响应报文
{
    "msg": "操作成功",
    "code": 200,
    "list": [
        {
        "id": 3,
        "specsname": "颜色",
        "status": 1,
        "attrs": [
            "白色",
            "黑色1"
          ]
        },
    ]
}

商品管理

说明

商品管理一共包括：商品添加、商品总数、商品列表、商品获取、商品修改、商品删除，共六个功能，负责商品的管理

商品添加

接口功能

商品添加

URL

/api/goodsadd

HTTP请求方式

POST

请求参数

参数名称	描述
first_cateid	一级分类编号
second_cateid	二级分类编号
goodsname	商品名称
price	商品价格
market_price	市场价格
img	商品图片（文件）
description	商品描述
specsid	商品规格编号
specsattr	商品规格属性
isnew	是否新品 1 ,2
ishot	是否热卖推荐 1, 2
status	状态1正常2禁用

返回数据

数据格式

{
  "msg": "添加成功",
  "code": 200,
  "list": []
}

状态码	描述
200	成功
403	参数正确，但是权限不够
500	参数错误，请检查传递的参数

举例

请求头：
Content-Type: multipart/form-data;

请求报文：
{
  first_cateid: 1
  second_cateid: 7
  goodsname: test
  price: 111
  market_price: 222
  specsid: 3
  specsattr: 白色
  description: <p>desc</p>
  isnew: 1
  ishot: 1
  status: 1
  img: (binary)
}

响应报文
{
  "msg": "添加成功",
  "code": 200,
  "list": []
}

商品总数

接口功能

商品总数

URL

/api/goodscount

HTTP请求方式

GET

请求参数

参数名称	描述
无	-

返回数据

数据格式

{
  "msg": "操作成功",
  "code": 200,
  "list": [
    {
    	"total": 10
    }
  ]
}

状态码	描述
200	成功
403	参数正确，但是权限不够
500	参数错误，请检查传递的参数

举例

请求头：

请求报文：


响应报文
{
  "msg": "操作成功",
  "code": 200,
  "list": [
    {
    	"total": 10
    }
  ]
}

商品列表（分页）

接口功能

商品列表（分页）

URL

/api/goodslist

HTTP请求方式

GET

请求参数

参数名称	描述
size	查询条数
page	页码数

返回数据

数据格式

{
  "msg": "操作成功",
  "code": 200,
  "list": [
      {
      "id": 1,
      "first_cateid": 2,
      "second_cateid": 10,
      "goodsname": "小米10",
      "price": 3999,
      "market_price": 3999,
      "img": "/uploads/fa5c2790-6c48-11ea-b894-9bd516f4e52e.jpg",
      "description": "<p>11</p><p>22</p><p>33</p>",
      "specsid": 3,
      "specsattr": "白色,黑色",
      "isnew": 0,
      "ishot": 1,
      "status": 1,
      "firstcatename": "手机通讯",
      "secondcatename": "手机"
      },
  ]
}

状态码	描述
200	成功
403	参数正确，但是权限不够
500	参数错误，请检查传递的参数

举例

请求头：

请求报文：
{
  page: 1
  size: 10
}

响应报文
{
  "msg": "操作成功",
  "code": 200,
  "list": [
      {
      "id": 1,
      "first_cateid": 2,
      "second_cateid": 10,
      "goodsname": "小米10",
      "price": 3999,
      "market_price": 3999,
      "img": "/uploads/fa5c2790-6c48-11ea-b894-9bd516f4e52e.jpg",
      "description": "<p>11</p><p>22</p><p>33</p>",
      "specsid": 3,
      "specsattr": "白色,黑色",
      "isnew": 0,
      "ishot": 1,
      "status": 1,
      "firstcatename": "手机通讯",
      "secondcatename": "手机"
      },
  ]
}

商品获取（一条）

接口功能

商品获取（一条）

URL

/api/goodsinfo

HTTP请求方式

GET

请求参数

参数名称	描述
id	商品编号

返回数据

数据格式

{
  "msg": "获取成功",
  "code": 200,
  "list": [
      {
        "id": 3,
        "specsname": "颜色",
        "status": 1,
        "attrs": [
          "白色",
          "黑色1"
        ]
      }
  ]
}

状态码	描述
200	成功
403	参数正确，但是权限不够
500	参数错误，请检查传递的参数

举例

请求头：

请求报文：
{
  id: 3
}

响应报文
{
  "msg": "获取成功",
  "code": 200,
  "list": [
      {
        "id": 3,
        "specsname": "颜色",
        "status": 1,
        "attrs": [
          "白色",
          "黑色1"
        ]
      }
  ]
}

商品修改

接口功能

商品修改

URL

/api/goodsedit

HTTP请求方式

POST

请求参数

参数名称	描述
id	分类编号，必填项
first_cateid	一级分类编号
second_cateid	二级分类编号
goodsname	商品名称
price	商品价格
market_price	市场价格
img	商品图片（文件）
description	商品描述
sepcsid	商品规格编号
sepcsattr	商品规格属性
isnew	是否新品
ishot	是否热卖推荐
status	状态1正常2禁用

返回数据

数据格式

{
  "msg": "操作成功",
  "code": 200,
  "list": []
}

状态码	描述
200	成功
403	参数正确，但是权限不够
500	参数错误，请检查传递的参数

举例

请求头：
Content-Type: multipart/form-data;

请求报文：
{
  first_cateid: 1
  second_cateid: 7
  goodsname: test
  price: 111
  market_price: 222
  img: /uploads/b0753ca0-ed19-11ea-bcca-0f3f79ffc6f0.jpg
  description: <p>desc</p>
  specsid: 3
  specsattr: 白色
  isnew: 1
  ishot: 1
  status: 1
id: 11
}

响应报文
{
  "msg": "操作成功",
  "code": 200,
  "list": []
}

商品删除

接口功能

商品删除

URL

/api/goodsdelete

HTTP请求方式

POST

请求参数

参数名称	描述
id	商品编号

返回数据

数据格式

{
  "msg": "操作成功",
  "code": 200,
  "list": [
      {
      "id": 1,
      "first_cateid": 2,
      "second_cateid": 10,
      "goodsname": "小米10",
      "price": 3999,
      "market_price": 3999,
      "img": "/uploads/fa5c2790-6c48-11ea-b894-9bd516f4e52e.jpg",
      "description": "<p>11</p><p>22</p><p>33</p>",
      "specsid": 3,
      "specsattr": "白色,黑色",
      "isnew": 0,
      "ishot": 1,
      "status": 1,
      "firstcatename": "手机通讯",
      "secondcatename": "手机"
      },
  ]
}

状态码	描述
200	成功
403	参数正确，但是权限不够
500	参数错误，请检查传递的参数

举例

请求头：

请求报文：
{
	id: 11
}

响应报文
{
  "msg": "操作成功",
  "code": 200,
  "list": [
      {
      "id": 1,
      "first_cateid": 2,
      "second_cateid": 10,
      "goodsname": "小米10",
      "price": 3999,
      "market_price": 3999,
      "img": "/uploads/fa5c2790-6c48-11ea-b894-9bd516f4e52e.jpg",
      "description": "<p>11</p><p>22</p><p>33</p>",
      "specsid": 3,
      "specsattr": "白色,黑色",
      "isnew": 0,
      "ishot": 1,
      "status": 1,
      "firstcatename": "手机通讯",
      "secondcatename": "手机"
      },
  ]
}

会员管理

说明

会员管理一共包括：会员列表、会员获取、会员修改，共三个功能，负责注册会员的管理

会员列表

接口功能

会员列表

URL

/api/memberlist

HTTP请求方式

GET

请求参数

参数名称	描述
无	-

返回数据

数据格式

{
  "msg": "操作成功",
  "code": 200,
  "list": [
  {
    "id": 2,
    "uid": "2be08210-70fa-11ea-9c17-a5b3f9b0d2ba",
    "phone": "18811112222",
    "nickname": "小U",
    "password": "",
    "randstr": "O6ImO",
    "addtime": "1585403036849",
    "status": 1
    },
  ]
}

状态码	描述
200	成功
403	参数正确，但是权限不够
500	参数错误，请检查传递的参数

举例


请求报文：

响应报文
{
  "msg": "操作成功",
  "code": 200,
  "list": [
  {
    "id": 2,
    "uid": "2be08210-70fa-11ea-9c17-a5b3f9b0d2ba",
    "phone": "18811112222",
    "nickname": "小U",
    "password": "",
    "randstr": "O6ImO",
    "addtime": "1585403036849",
    "status": 1
    },
  ]
}

会员获取

接口功能

会员获取

URL

/api/memberinfo

HTTP请求方式

GET

请求参数

参数名称	描述
uid	用户编号，必填项

返回数据

数据格式

{
  "msg": "获取成功",
  "code": 200,
  "list": {
      "uid": "2be08210-70fa-11ea-9c17-a5b3f9b0d2ba",
      "phone": "18811112222",
      "nickname": "小U",
      "password": "",
      "randstr": "O6ImO",
      "status": 1
  }
}

状态码	描述
200	成功
403	参数正确，但是权限不够
500	参数错误，请检查传递的参数

举例

请求报文：
{
	uid: 2be08210-70fa-11ea-9c17-a5b3f9b0d2ba
}
响应报文
{
  "msg": "获取成功",
  "code": 200,
  "list": {
      "uid": "2be08210-70fa-11ea-9c17-a5b3f9b0d2ba",
      "phone": "18811112222",
      "nickname": "小U",
      "password": "",
      "randstr": "O6ImO",
      "status": 1
  }
}

会员修改

接口功能

会员修改

URL

/api/memberedit

HTTP请求方式

POST

请求参数

参数名称	描述
uid	会员编号，必填项
nickname	昵称
phone	手机号
password	密码
status	状态1正常2禁用

返回数据

数据格式

{
  "msg": "操作成功",
  "code": 200,
  "list": []
}

状态码	描述
200	成功
403	参数正确，但是权限不够
500	参数错误，请检查传递的参数

举例

请求报文：
{
	id: "2be08210-70fa-11ea-9c17-a5b3f9b0d2ba"
  nickname: "小U2"
  password: ""
  phone: "18811112222"
  randstr: "O6ImO"
  status: 1
  uid: "2be08210-70fa-11ea-9c17-a5b3f9b0d2ba"
}
响应报文
{
  "msg": "操作成功",
  "code": 200,
  "list": []
}

轮播图管理

说明

轮播图管理一共包括：轮播图添加、轮播图列表、轮播图获取、轮播图修改、轮播图删除，共五个功能，负责轮播图的管理

轮播图添加

接口功能

轮播图添加

URL

/api/banneradd

HTTP请求方式

POST

请求参数

参数名称	描述
title	轮播图名称
img	图片(文件)
status	状态1正常2禁用

返回数据

数据格式

{
  "msg": "添加成功",
  "code": 200,
  "list": []
}

状态码	描述
200	成功
403	参数正确，但是权限不够
500	参数错误，请检查传递的参数

举例

请求头：
Content-Type: multipart/form-data;
请求报文：
{
  title: test
  status: 1
  img: (binary)
}
响应报文
{
  "msg": "添加成功",
  "code": 200,
  "list": []
}

轮播图列表

接口功能

轮播图列表

URL

/api/banneradd

HTTP请求方式

GET

请求参数

参数名称	描述
无	-

返回数据

数据格式

{
  "msg": "操作成功",
  "code": 200,
  "list": [
  {
    "id": 1,
    "title": "轮播图1",
    "img": "/uploads/banner/76744550-b51a-11ea-8f98-3b344c58e56b.jpg",
    "status": 1
    },
  ]
}

状态码	描述
200	成功
403	参数正确，但是权限不够
500	参数错误，请检查传递的参数

举例

请求头：

请求报文：

响应报文
{
  "msg": "操作成功",
  "code": 200,
  "list": [
  {
    "id": 1,
    "title": "轮播图1",
    "img": "/uploads/banner/76744550-b51a-11ea-8f98-3b344c58e56b.jpg",
    "status": 1
    },
  ]
}

轮播图获取（一条）

接口功能

轮播图获取（一条）

URL

/api/bannerinfo

HTTP请求方式

GET

请求参数

参数名称	描述
id	轮播图编号

返回数据

数据格式

{
    "msg": "获取成功",
    "code": 200,
    "list": {
        "title": "轮播图1",
        "img": "/uploads/banner/76744550-b51a-11ea-8f98-3b344c58e56b.jpg",
        "status": 1
    }
}

状态码	描述
200	成功
403	参数正确，但是权限不够
500	参数错误，请检查传递的参数

举例

请求头：

请求报文：
{
id: 1
}
响应报文
{
    "msg": "获取成功",
    "code": 200,
    "list": {
        "title": "轮播图1",
        "img": "/uploads/banner/76744550-b51a-11ea-8f98-3b344c58e56b.jpg",
        "status": 1
    }
}

轮播图修改

接口功能

轮播图修改

URL

/api/banneredit

HTTP请求方式

POST

请求参数

参数名称	描述
id	分类编号，必填项
title	轮播图名称
img	图片(文件)
status	状态1正常2禁用

返回数据

数据格式

{
  "msg": "操作成功",
  "code": 200,
  "list": []
}

状态码	描述
200	成功
403	参数正确，但是权限不够
500	参数错误，请检查传递的参数

举例

请求头：
Content-Type: multipart/form-data;

请求报文：
{
  title: 轮播图2
  img: /uploads/banner/76744550-b51a-11ea-8f98-3b344c58e56b.jpg
  status: 1
  id: 1
}
响应报文
{
  "msg": "操作成功",
  "code": 200,
  "list": []
}

轮播图删除

接口功能

轮播图删除

URL

/api/bannerdelete

HTTP请求方式

POST

请求参数

参数名称	描述
id	分类编号，必填项

返回数据

数据格式

{
    "msg": "操作成功",
    "code": 200,
    "list": [
        {
        "id": 1,
        "title": "轮播图2",
        "img": "/uploads/banner/76744550-b51a-11ea-8f98-3b344c58e56b.jpg",
        "status": 1
        },
    ]
}

状态码	描述
200	成功
403	参数正确，但是权限不够
500	参数错误，请检查传递的参数

举例

请求头：
Content-Type: multipart/form-data;

请求报文：
{
  id: 4
}
响应报文
{
    "msg": "操作成功",
    "code": 200,
    "list": [
        {
        "id": 1,
        "title": "轮播图2",
        "img": "/uploads/banner/76744550-b51a-11ea-8f98-3b344c58e56b.jpg",
        "status": 1
        },
    ]
}