# zaowu-admin **Repository Path**: nevermo2013/zaowu-admin ## Basic Information - **Project Name**: zaowu-admin - **Description**: 造物后台代码 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 0 - **Created**: 2018-11-02 - **Last Updated**: 2020-12-19 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README [TOC] # 页面前端接口部分 ### 用户接口 #### 1. 用户注册 - **请求URL** > [api/user/doRegister](#) - **请求方式** >**POST** - **请求参数** > | 请求参数 | 参数类型 | 能否为空 | 参数说明 | | :--------: | :--------:| :---------: | :------: | | user.username | String | false | 6~20位字母数字_| | user.password | String | false | 6-12位| - **返回参数** > | 返回参数 | 参数类型 | 参数说明 | | :--------: | :--------:| :---------: | | code | String | "S"/"F";"S"="success"| | data | Json | 内容部分| - **返回示例** > ```java { "code": "S", "data": { msg:"注册成功!" } ``` #### 2. 用户登录 - **请求URL** > [api/user/doLogin](#) - **请求方式** >**POST** - **请求参数** > | 请求参数 | 参数类型 | 能否为空 | 参数说明 | | :--------: | :--------:| :---------: | :------: | | user.username | String | false | 6~20位字母数字_| | user.password | String | false | 6-12位| - **返回参数** > | 返回参数 | 参数类型 | 参数说明 | | :--------: | :--------:| :---------: | | code | String | "S"/"F";"S"="success"| | data | Json | 内容部分| - **返回示例** > ```java { "code": "S", "data": { msg:"登录成功!" } ``` #### 2. 检查用户名是否可用 - **请求URL** > [api/user/checkUserName](#) - **请求方式** >**POST** - **请求参数** > | 请求参数 | 参数类型 | 能否为空 | 参数说明 | | :--------: | :--------:| :---------: | :------: | | username | String | false | 6~20位字母数字_| - **返回参数** > | 返回参数 | 参数类型 | 参数说明 | | :--------: | :--------:| :---------: | | code | String | "S"/"F";"S"="success"| | data | Json | 内容部分| - **返回示例** > ```java { "code": "S", "data": { msg:"" } ``` ### 分类页面 #### 1. 分类列表 - **请求URL** > [api/kind/list](#) - **请求方式** >**get** - **请求参数** > | 请求参数 | 参数类型 | 能否为空 | 参数说明 | | :--------: | :--------:| :---------: | :------: | - **返回参数** > | 返回参数 | 参数类型 | 参数说明 | | :--------: | :--------:| :---------: | | code | String | "S"/"F";"S"="success"| | data | Json | 内容部分| - **返回示例** > ```java { "code": "S", "data": [ { id:"xxxx", title:"chuangyi", ctitle:"创意", img:"xxx.jpg" subKind:[ { code:"001", title:"wazi", ctitle:"袜子" }, { code:"002", title:"weijin", ctitle:"围巾" }, ] }, { id:"xxxx", title:"neiyi", ctitle:"内衣", img:"xxx.jpg" subKind:[ { code:"001", title:"wazi", ctitle:"袜子" }, { code:"002", title:"weijin", ctitle:"围巾" }, ] }, ] ``` #### 2. 根据分类id获取商品列表 - **请求URL** > [api/kind/goodsListByKind](#) - **请求方式** >**get** - **请求参数** > | 请求参数 | 参数类型 | 能否为空 | 参数说明 | | :--------: | :--------:| :---------: | :------: | | subKindId | String | false | 子分类信息id | | sortBy | String | | 排序依据,比如priceNow,hot等 | | desc | String | | 为空降序,1为升序,0为降序 | - **返回参数** > | 返回参数 | 参数类型 | 参数说明 | | :--------: | :--------:| :---------: | | code | String | "S"/"F";"S"="success"| | data | Json | 内容部分| - **返回示例** > ```java { "code": "S", "data": [ { id:"xxxx", title:"纯棉围巾", cover:"xxx.jpg" }, { id:"xxxx", title:"电脑箱包", cover:"xxx.jpg" }, ] ``` #### 4. 查看商品明细 - **请求URL** > [api/kind/goodsDetail](#) - **请求方式** >**get** - **请求参数** > | 请求参数 | 参数类型 | 能否为空 | 参数说明 | | :--------: | :--------:| :---------: | :------: | | id | String | false | 商品id | - **返回参数** > | 返回参数 | 参数类型 | 参数说明 | | :--------: | :--------:| :---------: | | code | String | "S"/"F";"S"="success"| | data | Json | 内容部分| - **返回示例** > ```java { "code": "S", "data": { id:"xxxx", name:"纯棉围巾", brand:"热风", imgs:[ "a.jpg", "b.jpg" ], attrs:[ { code: "001", size:"s", color: "#666", lastCount: 999 }, { code: "002", size:"s", color: "#333", lastCount: 10 }, { code: "003", size:"M", color: "#333", lastCount: 0 } ] } ``` ### 评价信息 #### 1. 查看商品评价 - **请求URL** > [api/comments/list](#) - **请求方式** >**get** - **请求参数** > | 请求参数 | 参数类型 | 能否为空 | 参数说明 | | :--------: | :--------:| :---------: | :------: | | goodsId | String | false | 商品id | - **返回参数** > | 返回参数 | 参数类型 | 参数说明 | | :--------: | :--------:| :---------: | | code | String | "S"/"F";"S"="success"| | data | Json | 内容部分| - **返回示例** > ```java { "code": "S", "data": [ { id:"xxx", goodsId:"xxx", name:"zs", star:5, comment:"这件衣服不错!", ts:12394812348 //时间戳 }, { id:"xxx", goodsId:"xxx", name:"不凡君", star:3, comment:"很愉快的一次购物!", ts:12394812348 //时间戳 }, ] ``` #### 2. 查看商品评价 - **请求URL** > [api/comments/save](#) > [api/comments/update](#) - **请求方式** >**post** - **请求参数** > | 请求参数 | 参数类型 | 能否为空 | 参数说明 | | :--------: | :--------:| :---------: | :------: | | comments.id | String | | 评价id(save不需要添加) | | comments.goodsId | String | false | 商品id | | comments.comment | String | false | 评价内容 | | comments.star | String | false | 星级 | | comments.userName | String | false | 用户名 | - **返回参数** > | 返回参数 | 参数类型 | 参数说明 | | :--------: | :--------:| :---------: | | code | String | "S"/"F";"S"="success"| | data | Json | 内容部分| - **返回示例** > ```java { "code": "S", "data": {} ``` #### 3. 删除商品评价 - **请求URL** > [api/comments/del](#) - **请求方式** >**get** - **请求参数** > | 请求参数 | 参数类型 | 能否为空 | 参数说明 | | :--------: | :--------:| :---------: | :------: | | id | String | false | 评价id | - **返回参数** > | 返回参数 | 参数类型 | 参数说明 | | :--------: | :--------:| :---------: | | code | String | "S"/"F";"S"="success"| | data | Json | 内容部分| - **返回示例** > ```java { "code": "S", "data": {} ``` ### 我的 #### 1. 获取地址列表 (暂未实现) - **请求URL** > [api/my/address/list](#) - **请求方式** >**get** - **请求参数** > | 请求参数 | 参数类型 | 能否为空 | 参数说明 | | :--------: | :--------:| :---------: | :------: | | userId | String | false | 用户id | - **返回参数** > | 返回参数 | 参数类型 | 参数说明 | | :--------: | :--------:| :---------: | | code | String | "S"/"F";"S"="success"| | data | Json | 内容部分| - **返回示例** > ```java { "code": "S", "data":[ { userId:"xxx", name:"李先生", tag:"公司", p:"河南省", c:"郑州市", t:"郑东新区", bak: "金水路东风南路绿地新都会", tel: "1234234", use:true, //是否默认 addTime: 1234234 }, { } ] ``` #### 2. 新增/修改地址信息 (暂未实现) - **请求URL** > [api/my/address/save](#) > [api/my/address/update](#) - **请求方式** >**post** - **请求参数** > | 请求参数 | 能否为空 | 参数说明 | | :--------: | :---------: | :------: | | id | false | 地址id 新增不需要,修改需要| | userId | false | 用户Id,新增不需要,修改需要 | | tag | | 标签,公司,家... | | proCode | false | 省份code | | cityCode | false | 城市code | | townCode | false | 村镇code | | bak | false | 明细地址 | | name | false | 收件人 | | tel | false | 电话号码 | | use | | 是否默认,0否,1是 | - **返回参数** > | 返回参数 | 参数类型 | 参数说明 | | :--------: | :--------:| :---------: | | code | String | "S"/"F";"S"="success"| | data | Json | 内容部分| - **返回示例** > ```java { "code": "S", "data":{} ``` #### 3.删除地址 (暂未实现) - **请求URL** > [api/my/address/del](#) - **请求方式** >**get** - **请求参数** > | 请求参数 | 参数类型 | 能否为空 | 参数说明 | | :--------: | :--------:| :---------: | :------: | | id | String | false | 地址id | - **返回参数** > | 返回参数 | 参数类型 | 参数说明 | | :--------: | :--------:| :---------: | | code | String | "S"/"F";"S"="success"| | data | Json | 内容部分| - **返回示例** > ```java { "code": "S", "data":{} ``` #### 4.设置默认 (暂未实现) - **请求URL** > [api/my/address/setOne](#) - **请求方式** >**post** - **请求参数** > | 请求参数 | 参数类型 | 能否为空 | 参数说明 | | :--------: | :--------:| :---------: | :------: | | id | String | false | 地址id | - **返回参数** > | 返回参数 | 参数类型 | 参数说明 | | :--------: | :--------:| :---------: | | code | String | "S"/"F";"S"="success"| | data | Json | 内容部分| - **返回示例** > ```java { "code": "S", "data":{} ``` --- # 后台接口 ### 系统接口 #### 1. 查询数据词典 (暂未实现) - **请求URL** > [api/sys/dict/list](#) - **请求方式** >**get** - **请求参数** > | 请求参数 | 参数类型 | 能否为空 | 参数说明 | | :--------: | :--------:| :---------: | :------: | - **返回参数** > | 返回参数 | 参数类型 | 参数说明 | | :--------: | :--------:| :---------: | | code | String | "S"/"F";"S"="success"| | data | Json | 内容部分| - **返回示例** > ```java { "code": "S", "data": [{ { id: "xxx", name:"郑州", code: "001", pcode: "001", desc:"" }, { id: "xxx", name:"洛阳", code: "002", pcode: "001", desc:"" } ] ``` #### 2. 数据词典添加 (暂未实现) - **请求URL** > [api/sys/dict/save](#) > [api/sys/dict/update](#) - **请求方式** >**post** - **请求参数** > | 请求参数 | 能否为空 | 参数说明 | | :--------: | :---------: | :------: | | id| | 修改时为必须参数 | | name| false | | | code| false | | | pcode| false | | | pid| | | | desc| | | | level| | | - **返回参数** > | 返回参数 | 参数类型 | 参数说明 | | :--------: | :--------:| :---------: | | code | String | "S"/"F";"S"="success"| | data | Json | 内容部分| - **返回示例** > ```java { "code": "S", "data":{ msg:"" } ``` #### 3. 数据词典删除 (暂未实现) - **请求URL** > [api/sys/dict/del](#) - **请求方式** >**get** - **请求参数** > | 请求参数 | 能否为空 | 参数说明 | | :--------: | :---------: | :------: | | id| false | | - **返回参数** > | 返回参数 | 参数类型 | 参数说明 | | :--------: | :--------:| :---------: | | code | String | "S"/"F";"S"="success"| | data | Json | 内容部分| - **返回示例** > ```java { "code": "S", "data":{ msg:"" } ``` ### 商品信息管理页面 #### 1. 商品信息列表 - **请求URL** > [api/admin/goods/list](#) - **请求方式** >**get** - **请求参数** > | 请求参数 | 能否为空 | 参数说明 | | :--------: | :---------: | :------: | | start | | 分页start值,从1开始,默认1 | | limit | | 分页limit值,默认10 | - **返回参数** > | 返回参数 | 参数类型 | 参数说明 | | :--------: | :--------:| :---------: | | code | String | "S"/"F";"S"="success"| | data | Json | 内容部分| - **返回示例** > ```java { "code": "S", "data": [ { id: "xxx", brand: "热风", name: "裤子", priceIn: 200.00, // 进价 priceNow: 210.00, // 现价/打折 priceOut: 220.00, // 卖出价格 lastCount: 999, //库存 hot: 0, // 0 正常,1 热卖 addTime: 1234234, }, { id: "xxx", brand: "热风", name: "裤子", priceIn: 200.00, // 进价 priceNow: 210.00, // 现价/打折 priceOut: 220.00, // 卖出价格 lastCount: 999, //库存 hot: 0, // 0 正常,1 热卖 addTime: 1234234, }, ] ``` #### 2. 商品信息添加 - **请求URL** > [api/admin/goods/save](#) > [api/admin/goods/update](#) - **请求方式** >**post** - **请求参数** > | 请求参数 | 能否为空 | 参数说明 | | :--------:| :---------: | :------: | | goods.id| | 商品id,修改时 必须 | | goods.kindId| | 分类id,必须先有分类 | | goods.brandId| false | 品牌id | | goods.name | false | 名称 | | goods.desc | false | 描述 | | goods.priceIn | false | 进价 | | goods.priceOut | false | 卖出价格 | | goods.priceNow | false | 打折/当前价格 | | goods.hot | | 0 默认 ,1 为热卖 | | goods.img1 | | banner 轮播图1 | | goods.img2 | | banner 轮播图2 | | goods.img3 | | banner 轮播图3 | | goods.color1 | | 颜色1, #000000 ,十六进制 | | goods.color2 | | 颜色2, #000000 ,十六进制 | | goods.color3 | | 颜色3, #000000 ,十六进制 | | goods.size_s | | 0 为不存在,1 为存在| | goods.size_m | | 0 为不存在,1 为存在| | goods.size_l | | 0 为不存在,1 为存在| | goods.contentSource || 商品页面描述信息,富文本原内容| | goods.content || 商品页面描述信息,富文本转换后html| - **返回参数** > | 返回参数 | 参数类型 | 参数说明 | | :--------: | :--------:| :---------: | | code | String | "S"/"F";"S"="success"| | data | Json | 内容部分| - **返回示例** > ```java { "code": "S", "data": {} ``` #### 3. 商品信息删除 - **请求URL** > [api/admin/goods/del](#) - **请求方式** >**get** - **请求参数** > | 请求参数 | 能否为空 | 参数说明 | | :--------:| :---------: | :------: | | id| | 商品id,修改时 必须 | - **返回参数** > | 返回参数 | 参数类型 | 参数说明 | | :--------: | :--------:| :---------: | | code | String | "S"/"F";"S"="success"| | data | Json | 内容部分| - **返回示例** > ```java { "code": "S", "data": {} ``` #### 4. 二级商品信息 - **请求URL** > [api/admin/goods/stockList](#) - **请求方式** >**get** - **请求参数** > | 请求参数 | 参数类型 | 能否为空 | 参数说明 | | :--------: | :--------:| :---------: | :------: | | id | | |商品id | - **返回参数** > | 返回参数 | 参数类型 | 参数说明 | | :--------: | :--------:| :---------: | | code | String | "S"/"F";"S"="success"| | data | Json | 内容部分| - **返回示例** > ```java { "code": "S", "data": [ { id: "xxx", brand: "热风", name: "裤子", priceIn: 200.00, // 进价 priceNow: 210.00, // 现价/打折 priceOut: 220.00, // 卖出价格 lastCount: 999, //库存 hot: 0, // 0 正常,1 热卖 addTime: 1234234, }, { id: "xxx", brand: "热风", name: "裤子", priceIn: 200.00, // 进价 priceNow: 210.00, // 现价/打折 priceOut: 220.00, // 卖出价格 lastCount: 999, //库存 hot: 0, // 0 正常,1 热卖 addTime: 1234234, }, ] ``` #### 5. 商品库存信息添加 - **请求URL** > [api/admin/goods/saveStock](#) > [api/admin/goods/updateStock](#) - **请求方式** >**post** - **请求参数** > | 请求参数 | 能否为空 | 参数说明 | | :--------:| :---------: | :------: | | goodsStock.id| | 库存信息id,修改时 必须 | | goodsStock.goodsId| false | 商品id | | goodsStock.color| false | color: #000000 商品颜色 | | goodsStock.size| false | m 商品size| | goodsStock.count| false | 库存数量 | - **返回参数** > | 返回参数 | 参数类型 | 参数说明 | | :--------: | :--------:| :---------: | | code | String | "S"/"F";"S"="success"| | data | Json | 内容部分| - **返回示例** > ```java { "code": "S", "data": {} ``` #### 6. 删除商品库存信息 - **请求URL** > [api/admin/goods/delStock](#) - **请求方式** >**get** - **请求参数** > | 请求参数 | 能否为空 | 参数说明 | | :--------:| :---------: | :------: | | id| | 库存信息id | - **返回参数** > | 返回参数 | 参数类型 | 参数说明 | | :--------: | :--------:| :---------: | | code | String | "S"/"F";"S"="success"| | data | Json | 内容部分| - **返回示例** > ```java { "code": "S", "data": {}________ ``` #### 7. 根据id查询商品信息 - **请求URL** > [api/admin/goods/goodsDetail](#) > [api/admin/goods/goodsStockDetail](#) - **请求方式** >**get** - **请求参数** > | 请求参数 | 能否为空 | 参数说明 | | :--------:| :---------: | :------: | | id| false | | - **返回参数** > | 返回参数 | 参数类型 | 参数说明 | | :--------: | :--------:| :---------: | | data | Json | 内容部分| - **返回示例** > ```java { "code": "S", "data": {}________ ``` ### 分类页面接口 #### 1. 分类展示 - **请求URL** > [api/admin/kind/list](#) - **请求方式** >**get** - **请求参数** > | 请求参数 | 参数类型 | 能否为空 | 参数说明 | | :--------: | :--------:| :---------: | :------: | - **返回参数** > | 返回参数 | 参数类型 | 参数说明 | | :--------: | :--------:| :---------: | | code | String | "S"/"F";"S"="success"| | data | Json | 内容部分| - **返回示例** > ```java { "code": "S", "data": [ { id:"xxxx", title:"chuangyi", ctitle:"创意", img:"xxx.jpg" subKind:[ { id:"xx", title:"wazi", ctitle:"袜子", level:1 }, { id:"xx", title:"weijin", ctitle:"围巾", level:2 }, ] }, { id:"xxxx", title:"neiyi", ctitle:"内衣", img:"xxx.jpg" subKind:[ { id:"xx", title:"wazi", ctitle:"袜子", level:1 }, { id:"xx", title:"weijin", ctitle:"围巾", level:2 }, ] }, ] ``` #### 2. 分类页面添加分类 - **请求URL** > [api/admin/kind/save](#) > [api/admin/kind/update](#) - **请求方式** >**post** - **请求参数** > | 请求参数 | 能否为空 | 参数说明 | | :--------: | :---------: | :------: | | goodsKind.id | | 更新必须,添加不要 | | goodsKind.title | false | 当前分类标题 | | goodsKind.pid | | 一级默认传0,添加子类必须有父类id | | goodsKind.ctitle | false | 当前分类拼音/英文标题(路由可能用到) | | goodsKind.img | | 添加子类可以不要 | | goodsKind.level | | 序号 降序,9,8,7... | - **返回参数** > | 返回参数 | 参数类型 | 参数说明 | | :--------: | :--------:| :---------: | | code | String | "S"/"F";"S"="success"| | data | Json | 内容部分| - **返回示例** > ```java { "code": "S", "data":{} ``` #### 2. 分类页面删除分类 - **请求URL** > [api/admin/kind/del](#) - **请求方式** >**get** - **请求参数** > | 请求参数 | 能否为空 | 参数说明 | | :--------: | :---------: | :------: | | id | | 更新必须,添加不要 | | type | | 删除父类type=0,删除子类type=1,默认1 | - **返回参数** > | 返回参数 | 参数类型 | 参数说明 | | :--------: | :--------:| :---------: | | code | String | "S"/"F";"S"="success"| | data | Json | 内容部分| - **返回示例** > ```java { "code": "S", "data":{} ``` ### 上传管理 #### 1. 图片上传 - **请求URL** > [api/admin/upload](#) - **请求方式** >**post** - **请求参数** > | 请求参数 | 能否为空 | 参数说明 | | :--------: |:---------: | :------: | - **返回参数** > | 返回参数 | 参数类型 | 参数说明 | | :--------: | :--------:| :---------: | | code | String | "S"/"F";"S"="success"| | data | Json | 内容部分| - **返回示例** > ```java { "code": "S", "data": {} ``` ### 订单管理页面 (暂未实现) #### 1. 订单列表 - **请求URL** > [api/admin/order/list](#) - **请求方式** >**get** - **请求参数** > | 请求参数 | 能否为空 | 参数说明 | | :--------: |:---------: | :------: | |state | | 默认0; 0未发货;1已发货;2已签收;3 | - **返回参数** > | 返回参数 | 参数类型 | 参数说明 | | :--------: | :--------:| :---------: | | code | String | "S"/"F";"S"="success"| | data | Json | 内容部分| - **返回示例** > ```java { "code": "S", "data": {} ``` #### 2. 修改订单状态 - **请求URL** > [api/admin/order/updateState](#) - **请求方式** >**get** - **请求参数** > | 请求参数 | 能否为空 | 参数说明 | | :--------: |:---------: | :------: | |id | false | 默认0; 0未发货;1已发货;2已签收;3 | |state | | 默认0; 0未发货;1已发货;2已签收;3 | - **返回参数** > | 返回参数 | 参数类型 | 参数说明 | | :--------: | :--------:| :---------: | | code | String | "S"/"F";"S"="success"| | data | Json | 内容部分| - **返回示例** > ```java { "code": "S", "data": {} ```