Loading... ## 每日一听 ## [Meting] [Music server="netease" id="1453702888" type="song"/] [/Meting] ## 登录界面 ## ### 1、判断账号密码 ### > 请求方式：GET > 请求地址：http://localhost:8080/admin/login #### 请求参数 #### | 参数 | 是否必填 | 说明 | | --- | --- | --- | | username | 是 | 用户名 | | password | 是 | 用户名 | | state | 是 | 状态 | #### 返回参数 #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | state | 接口状态码 | Number | 未登录或登录已过期（-1），成功（0），失败（1） | 是 | | msg | 接口信息 | String | | 是 | | data | 数据 | Object | | 否 | #### json示例 #### ```json { state:-1, msg:"未登录或登录已过期", data:null } { state:0, msg:"登录成功", data:null } { state:1, msg:"用户名错误", data:null } { state:1, msg:"密码错误", data:null } { state:1, msg:"账号已被封禁", data:null } ``` ### 2、判断权限 ### > 请求方式：GET > 请求地址：http://localhost:8080/admin/info #### 返回参数 #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | state | 接口状态码 | Number | 成功（0），失败（1） | 是 | | msg | 接口信息 | String | 成功（sucess），失败（error） | 是 | | data | 数据 | Object | | 是 | #### data #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | username | 用户名 | String | | 是 | | img | 头像 | String | | 是 | | permissionNames | 权限 | list | | 是 | #### json示例 #### ```json { state: 0, msg: "sucess", data: { username: "zhangsan", img: "https://wndoss.xlsea.cn/image/admin/%E5%BE%AE%E4%BF%A1%E5%9B%BE%E7%89%87_20211026202356.png", permissionNames: [ "admin:admin", "admin:user", "admin:merchant", "admin:rider" ] } } ``` ### 3、退出登录 ### > 请求方式：GET > 请求地址：http://localhost:8080/admin/logout #### 返回参数 #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | state | 接口状态码 | Number | 成功（0），失败（1） | 是 | | msg | 接口信息 | String | 成功（sucess），失败（error） | 是 | | data | 数据 | Object | | 是 | #### json示例 #### ```json { state:0, msg:"sucess", data:null } ``` ---------- ## 首页仪表盘 ## ### 1、用户、评论、订单、金额统计 ### > 请求方式：GET > 请求地址：http://localhost:8080/home/group #### 返回参数 #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | state | 接口状态码 | Number | 成功（0），失败（1） | 是 | | msg | 接口信息 | String | 成功（sucess），失败（error） | 是 | | data | 数据 | Object | | 是 | #### data #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | person | 用户数量 | Number | | 是 | | comment | 评论数量 | Number | | 是 | | money | 金额总额 | Number | | 是 | | order | 订单数量 | Number | | 是 | #### json示例 #### ```json { state:0, msg:"sucess", data:{ person :30, comment: 60, money: 366.00, order: 130 } } ``` ### 2、柱状统计表（用户统计） ### > 请求方式：GET > 请求地址：http://localhost:8080/home/chart #### 返回参数 #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | state | 接口状态码 | Number | 成功（0），失败（1） | 是 | | msg | 接口信息 | String | 成功（sucess），失败（error） | 是 | | data | 数据 | Object | | 是 | #### data #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | person | 管理员、商家、骑手、用户数量 | list | | 是 | #### json示例 #### ```json { state:0, msg:"sucess", data:{ person: [10,20,30,20] } } ``` ---------- ## 管理员界面 ## ### 1、查询所有管理员信息（分页）（根据用户名，状态模糊查询） ### > 请求方式：GET > 请求地址：http://localhost:8080/admin/list #### 请求参数 #### | 参数 | 是否必填 | 说明 | | --- | --- | --- | | page | 是 | 当前页数 | | limit | 是 | 每页显示的条数 | | username | 否 | 用户名 | | state | 否 | 状态 | #### 返回参数 #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | state | 接口状态码 | Number | 成功（0），失败（1） | 是 | | msg | 接口信息 | String | 成功（sucess），失败（error） | 是 | | data | 数据 | Object | | 是 | #### data #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | total | 查询到的总条数 | Number | | 是 | | list | 管理员信息 | Object | | 是 | #### list #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | adminId | ID | Number | | 是 | | img | 头像 | String | 是 | | username | 用户名 | String | | 是 | | password | 密码 | String | | 是 | | stateName | 状态 | String | | 是 | #### json示例 #### ```json { state:0, msg:"sucess", data:{ total: 20, list:[ { adminId: 1, img: "https://wndoss.xlsea.cn/image/admin/%E5%BE%AE%E4%BF%A1%E5%9B%BE%E7%89%87_20211026202356.png", username: "zhangsan", password: "123456", stateName: "封禁" } ] } } ``` ### 2、添加管理员 ### > 请求方式：POST > 请求地址：http://localhost:8080/admin/add #### 请求参数 #### | 参数 | 是否必填 | 说明 | | --- | --- | --- | | username | 是 | 用户名 | | img | 是 | 头像 | | password | 是 | 密码 | | state | 是 | 状态 | #### 返回参数 #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | state | 接口状态码 | Number | 成功（0），失败（1） | 是 | | msg | 接口信息 | String | 成功（sucess），失败（error） | 是 | #### json示例 #### ```json { state:0, msg:"sucess", } ``` ### 3、修改管理员信息 ### > 请求方式：POST > 请求地址：http://localhost:8080/admin/rev #### 请求参数 #### | 参数 | 是否必填 | 说明 | | --- | --- | --- | | adminId | 是 | ID | | img | 否 | 头像 | | username | 否 | 用户名 | | password | 否 | 密码 | | state | 否 | 状态 | #### 返回参数 #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | state | 接口状态码 | Number | 成功（0），失败（1） | 是 | | msg | 接口信息 | String | 成功（sucess），失败（error） | 是 | #### json示例 #### ```json { state:0, msg:"sucess", } ``` ### 4、修改管理员状态 ### > 请求方式：POST > 请求地址：http://localhost:8080/admin/revState #### 请求参数 #### | 参数 | 是否必填 | 说明 | | --- | --- | --- | | adminId | 是 | ID | | state | 是 | 状态 | #### 返回参数 #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | state | 接口状态码 | Number | 成功（0），失败（1） | 是 | | msg | 接口信息 | String | 成功（sucess），失败（error） | 是 | #### json示例 #### ```json { state:0, msg:"sucess", } ``` ### 5、删除管理员 ### > 请求方式：GET > 请求地址：http://localhost:8080/admin/del #### 请求参数 #### | 参数 | 是否必填 | 说明 | | --- | --- | --- | | adminId | 是 | ID | #### 返回参数 #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | state | 接口状态码 | Number | 成功（0），失败（1） | 是 | | msg | 接口信息 | String | 成功（sucess），失败（error） | 是 | #### json示例 #### ```json { state:0, msg:"sucess", } ``` ---------- ## 商家界面 ## ### 1、查询所有商家信息（分页）（根据用户名，商家名，手机号，状态模糊查询） ### > 请求方式：GET > 请求地址：http://localhost:8080/merchant/list #### 请求参数 #### | 参数 | 是否必填 | 说明 | | --- | --- | --- | | page | 是 | 当前页数 | | limit | 是 | 每页显示的条数 | | username | 否 | 用户名 | | name | 否 | 商家名 | | phone | 否 | 手机号 | | state | 否 | 状态 | #### 返回参数 #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | state | 接口状态码 | Number | 成功（0），失败（1） | 是 | | msg | 接口信息 | String | 成功（sucess），失败（error） | 是 | | data | 数据 | Object | | 是 | #### data #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | total | 查询到的总条数 | Number | | 是 | | list | 商家信息 | Object | | 是 | #### list #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | mid | ID | Number | | 是 | | username | 用户名 | String | | 是 | | password | 密码 | String | | 是 | | img | 头像 | String | 是 | | name | 商家名 | String | | 是 | | shopName | 店铺名 | String | 商家名下的店铺 | 是 | | sex | 性别 | String | | 是 | | phone | 手机号 | String | | 是 | | balance | 余额 | Number | | 是 | | stateName | 状态 | String | | 是 | #### json示例 #### ```json { state:0, msg:"sucess", data:{ total: 20, list:[ { mid: 1, username: "zhangsan", password: "123456", img : "https://wndoss.xlsea.cn/image/merchant/%E5%BE%AE%E4%BF%A1%E5%9B%BE%E7%89%87_20211026202356.png" name: "张三", shopName: "三个先森的韩国炸鸡", sex: "男", phone: "18596547563", balance: "0.00", stateName: "封禁", } ] } } ``` ### 2、添加商家 ### > 请求方式：POST > 请求地址：http://localhost:8080/merchant/add #### 请求参数 #### | 参数 | 是否必填 | 说明 | | --- | --- | --- | | username | 是 | 用户名 | | password | 是 | 密码 | | img | 是 | 头像 | | name | 是 | 商家名 | | sex | 是 | 性别 | | phone | 是 | 手机号 | | balance | 是 | 余额 | | state | 是 | 状态 | #### 返回参数 #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | state | 接口状态码 | Number | 成功（0），失败（1） | 是 | | msg | 接口信息 | String | 成功（sucess），失败（error） | 是 | #### json示例 #### ```json { state:0, msg:"sucess", } ``` ### 3、修改商家信息 ### > 请求方式：POST > 请求地址：http://localhost:8080/merchant/rev #### 请求参数 #### | 参数 | 是否必填 | 说明 | | --- | --- | --- | | mid | 是 | ID | | password | 否 | 密码 | | img | 否 | 头像 | | phone | 否 | 手机号 | | state | 否 | 状态 | #### 返回参数 #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | state | 接口状态码 | Number | 成功（0），失败（1） | 是 | | msg | 接口信息 | String | 成功（sucess），失败（error） | 是 | #### json示例 #### ```json { state:0, msg:"sucess", } ``` ### 4、修改商家状态 ### > 请求方式：POST > 请求地址：http://localhost:8080/merchant/revState #### 请求参数 #### | 参数 | 是否必填 | 说明 | | --- | --- | --- | | mid | 是 | ID | | state | 是 | 状态 | #### 返回参数 #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | state | 接口状态码 | Number | 成功（0），失败（1） | 是 | | msg | 接口信息 | String | 成功（sucess），失败（error） | 是 | #### json示例 #### ```json { state:0, msg:"sucess", } ``` ### 5、删除商家 ### > 请求方式：GET > 请求地址：http://localhost:8080/merchant/del #### 请求参数 #### | 参数 | 是否必填 | 说明 | | --- | --- | --- | | mid | 是 | ID | #### 返回参数 #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | state | 接口状态码 | Number | 成功（0），失败（1） | 是 | | msg | 接口信息 | String | 成功（sucess），失败（error） | 是 | #### json示例 #### ```json { state:0, msg:"sucess", } ``` ---------- ## 用户界面 ## ### 1、查询所有用户信息（分页）（根据用户名，手机号，会员状态，状态模糊查询） ### > 请求方式：GET > 请求地址：http://localhost:8080/user/list #### 请求参数 #### | 参数 | 是否必填 | 说明 | | --- | --- | --- | | page | 是 | 当前页数 | | limit | 是 | 每页显示的条数 | | username | 否 | 用户名 | | phone | 否 | 手机号 | | vipState | 否 | 会员状态 | | state | 否 | 状态 | #### 返回参数 #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | state | 接口状态码 | Number | 成功（0），失败（1） | 是 | | msg | 接口信息 | String | 成功（sucess），失败（error） | 是 | | data | 数据 | Object | | 是 | #### data #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | total | 查询到的总条数 | Number | | 是 | | list | 用户信息 | Object | | 是 | #### list #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | uid | ID | Number | | 是 | | img | 头像 | String | | 是 | | username | 用户名 | String | | 是 | | password | 密码 | String | | 是 | | sex | 性别 | String | | 是 | | phone | 手机号 | String | | 是 | | balance | 余额 | Number | | 是 | | vip | 会员信息 | String | 会员（开通时间 至 结束时间），非会员（非会员） | 是 | | stateName | 状态 | String | | 是 | #### json示例 #### ```json { state:0, msg:"sucess", data:{ total: 20, list:[ { uid: 1, img: "%https://wndwm.xlsea.cn/image/user/%E5%BE%AE%E4%BF%A1%E5%9B%BE%E7%89%87_20211026202356.png", username: "zhangsan", password: "123456", sex: "男", phone: "18596547563", balance: "0.00", vip: "2021-10-10 00:00:00 至 2021-11-9 00:00:00", stateName: "封禁", } ] } } ``` ### 2、添加用户 ### > 请求方式：POST > 请求地址：http://localhost:8080/user/add #### 请求参数 #### | 参数 | 是否必填 | 说明 | | --- | --- | --- | | img | 头像 | 是 | | username | 用户名 | 是 | | password | 密码 | 是 | | img | 是 | 头像 | | sex | 性别 | 是 | | phone | 手机号 | 是 | | balance | 余额 | 是 | | stateName | 状态 | 是 | #### 返回参数 #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | state | 接口状态码 | Number | 成功（0），失败（1） | 是 | | msg | 接口信息 | String | 成功（sucess），失败（error） | 是 | #### json示例 #### ```json { state:0, msg:"sucess", } ``` ### 3、修改用户信息 ### > 请求方式：POST > 请求地址：http://localhost:8080/user/rev #### 请求参数 #### | 参数 | 是否必填 | 说明 | | --- | --- | --- | | uid | 是 | ID | | img | 否 | 头像 | | password | 否 | 密码 | | phone | 否 | 手机号 | | stateName | 否 | 状态 | #### 返回参数 #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | state | 接口状态码 | Number | 成功（0），失败（1） | 是 | | msg | 接口信息 | String | 成功（sucess），失败（error） | 是 | #### json示例 #### ```json { state:0, msg:"sucess", } ``` ### 4、修改用户状态 ### > 请求方式：POST > 请求地址：http://localhost:8080/user/revState #### 请求参数 #### | 参数 | 是否必填 | 说明 | | --- | --- | --- | | uid | 是 | ID | | state | 是 | 状态 | #### 返回参数 #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | state | 接口状态码 | Number | 成功（0），失败（1） | 是 | | msg | 接口信息 | String | 成功（sucess），失败（error） | 是 | #### json示例 #### ```json { state:0, msg:"sucess", } ``` ### 5、删除用户 ### > 请求方式：GET > 请求地址：http://localhost:8080/user/del #### 请求参数 #### | 参数 | 是否必填 | 说明 | | --- | --- | --- | | uid | 是 | ID | #### 返回参数 #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | state | 接口状态码 | Number | 成功（0），失败（1） | 是 | | msg | 接口信息 | String | 成功（sucess），失败（error） | 是 | #### json示例 #### ```json { state:0, msg:"sucess", } ``` ---------- ## 骑手界面 ## ### 1、查询所有骑手信息（分页）（根据用户名，骑手名，手机号，状态模糊查询） ### > 请求方式：GET > 请求地址：http://localhost:8080/merchant/list #### 请求参数 #### | 参数 | 是否必填 | 说明 | | --- | --- | --- | | page | 是 | 当前页数 | | limit | 是 | 每页显示的条数 | | username | 否 | 用户名 | | name | 否 | 骑手名 | | phone | 否 | 手机号 | | state | 否 | 状态 | #### 返回参数 #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | state | 接口状态码 | Number | 成功（0），失败（1） | 是 | | msg | 接口信息 | String | 成功（sucess），失败（error） | 是 | | data | 数据 | Object | | 是 | #### data #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | total | 查询到的总条数 | Number | | 是 | | list | 骑手信息 | Object | | 是 | #### list #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | rid | ID | Number | | 是 | | username | 用户名 | String | | 是 | | password | 密码 | String | | 是 | | img | 头像 | String | | 是 | | name | 骑手名 | String | | 是 | | sex | 性别 | String | | 是 | | phone | 手机号 | String | | 是 | | balance | 余额 | Number | | 是 | | stateName | 状态 | String | | 是 | #### json示例 #### ```json { state:0, msg:"sucess", data:{ total: 20, list:[ { mid: 1, username: "zhangsan", password: "123456", img: "https://wndoss.xlsea.cn/image/merchant/%E5%BE%AE%E4%BF%A1%E5%9B%BE%E7%89%87_20211026202356.png", name: "张三", sex: "男", phone: "18596547563", balance: "0.00", stateName: "封禁", } ] } } ``` ### 2、添加骑手 ### > 请求方式：POST > 请求地址：http://localhost:8080/rider/add #### 请求参数 #### | 参数 | 是否必填 | 说明 | | --- | --- | --- | | username | 是 | 用户名 | | password | 是 | 密码 | | img | 是 | 头像 | | name | 是 | 骑手名 | | sex | 是 | 性别 | | phone | 是 | 手机号 | | balance | 是 | 余额 | | state | 是 | 状态 | #### 返回参数 #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | state | 接口状态码 | Number | 成功（0），失败（1） | 是 | | msg | 接口信息 | String | 成功（sucess），失败（error） | 是 | #### json示例 #### ```json { state:0, msg:"sucess", } ``` ### 3、修改骑手信息 ### > 请求方式：POST > 请求地址：http://localhost:8080/rider/rev #### 请求参数 #### | 参数 | 是否必填 | 说明 | | --- | --- | --- | | rid | 是 | ID | | password | 否 | 密码 | | phone | 否 | 手机号 | | img | 否 | 头像 | | state | 否 | 状态 | #### 返回参数 #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | state | 接口状态码 | Number | 成功（0），失败（1） | 是 | | msg | 接口信息 | String | 成功（sucess），失败（error） | 是 | #### json示例 #### ```json { state:0, msg:"sucess", } ``` ### 4、修改骑手状态 ### > 请求方式：POST > 请求地址：http://localhost:8080/rider/revState #### 请求参数 #### | 参数 | 是否必填 | 说明 | | --- | --- | --- | | rid | 是 | ID | | state | 是 | 状态 | #### 返回参数 #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | state | 接口状态码 | Number | 成功（0），失败（1） | 是 | | msg | 接口信息 | String | 成功（sucess），失败（error） | 是 | #### json示例 #### ```json { state:0, msg:"sucess", } ``` ### 5、删除骑手 ### > 请求方式：GET > 请求地址：http://localhost:8080/rider/del #### 请求参数 #### | 参数 | 是否必填 | 说明 | | --- | --- | --- | | rid | 是 | ID | #### 返回参数 #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | state | 接口状态码 | Number | 成功（0），失败（1） | 是 | | msg | 接口信息 | String | 成功（sucess），失败（error） | 是 | #### json示例 #### ```json { state:0, msg:"sucess", } ``` ---------- ## 店铺页面（管理员） ## ### 1、查询所有店铺信息（分页）（根据商家名，店铺名，地址模糊查询） ### > 请求方式：GET > 请求地址：http://localhost:8080/shop/list #### 请求参数 #### | 参数 | 是否必填 | 说明 | | --- | --- | --- | | page | 是 | 当前页数 | | limit | 是 | 每页显示的条数 | | name | 否 | 商家名 | | shopName | 否 | 店铺名 | | shopAddress | 否 | 地址 | #### 返回参数 #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | state | 接口状态码 | Number | 成功（0），失败（1） | 是 | | msg | 接口信息 | String | 成功（sucess），失败（error） | 是 | | data | 数据 | Object | | 是 | #### data #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | total | 查询到的总条数 | Number | | 是 | | list | 店铺信息 | Object | | 是 | #### list #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | sid | ID | Number | | 是 | | img | 店铺头像 | String | | 是 | | shopName | 店铺名 | String | | 是 | | shopInfo | 店铺简介 | String | | 是 | | shopAddress | 店铺地址 | String | | 是 | | name | 商家名 | String | | 是 | #### json示例 #### ```json { state:0, msg:"sucess", data:{ total: 20, list:[ { sid: 1, img: "https://wndoss.xlsea.cn/image/shop/8fce4df10ca9fd46bcf0dd4e5d7c83d.png", shopName: "三个先森的韩国炸鸡", shopInfo: "三个先森的韩国炸鸡是一家全国连锁的品牌炸鸡店，欢迎下单！", shopAddress: "天津省天津市开发区翠亨村B座底商4-10A", name: "张三" } ] } } ``` ### 2、查询店铺信息（商家） ### > 请求方式：GET > 请求地址：http://localhost:8080/shop/merchant #### 请求参数 #### | 参数 | 是否必填 | 说明 | | --- | --- | --- | | page | 是 | 当前页数 | | limit | 是 | 每页显示的条数 | | username | 是 | 用户名 | #### 返回参数 #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | state | 接口状态码 | Number | 成功（0），失败（1） | 是 | | msg | 接口信息 | String | 成功（sucess），失败（error） | 是 | | data | 数据 | Object | | 是 | #### data #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | list | 店铺信息 | Object | | 是 | | img | 店铺头像 | String | | 是 | | shopName | 店铺名 | String | | 是 | | shopInfo | 店铺简介 | String | | 是 | | shopAddress | 店铺地址 | String | | 是 | | name | 商家名 | String | | 是 | #### json示例 #### ```json { state:0, msg:"sucess", data:{ img: "https://wndoss.xlsea.cn/image/shop/8fce4df10ca9fd46bcf0dd4e5d7c83d.png", shopName: "三个先森的韩国炸鸡", shopInfo: "三个先森的韩国炸鸡是一家全国连锁的品牌炸鸡店，欢迎下单！", shopAddress: "天津省天津市开发区翠亨村B座底商4-10A", name: "张三" } } ``` ### 3、修改店铺信息 ### > 请求方式：POST > 请求地址：http://localhost:8080/shop/rev #### 请求参数 #### | 参数 | 是否必填 | 说明 | | --- | --- | --- | | sid | 是 | ID | | img | 否 | 店铺头像 | | shopName | 否 | 店铺名 | | shopInfo | 否 | 店铺简介 | | shopAddress | 否 | 店铺地址 | | name | 否 | 商家名 | #### 返回参数 #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | state | 接口状态码 | Number | 成功（0），失败（1） | 是 | | msg | 接口信息 | String | 成功（sucess），失败（error） | 是 | #### json示例 #### ```json { state:0, msg:"sucess", } ``` ### 4、删除店铺 ### > 请求方式：GET > 请求地址：http://localhost:8080/shop/del #### 请求参数 #### | 参数 | 是否必填 | 说明 | | --- | --- | --- | | sid | 是 | ID | #### 返回参数 #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | state | 接口状态码 | Number | 成功（0），失败（1） | 是 | | msg | 接口信息 | String | 成功（sucess），失败（error） | 是 | #### json示例 #### ```json { state:0, msg:"sucess", } ``` ---------- ## 菜品页面（商家） ## ### 1、查询菜品信息（分页）（根据菜品名、分类名模糊查询） ### > 请求方式：GET > 请求地址：http://localhost:8080/product/list #### 请求参数 #### | 参数 | 是否必填 | 说明 | | --- | --- | --- | | page | 是 | 当前页数 | | limit | 是 | 每页显示的条数 | | username | 是 | 商家登录时的用户名 | | proName | 否| 菜品名 | | sortName | 否 | 分类名 | #### 返回参数 #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | state | 接口状态码 | Number | 成功（0），失败（1） | 是 | | msg | 接口信息 | String | 成功（sucess），失败（error） | 是 | | data | 数据 | Object | | 是 | #### data #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | total | 查询到的总条数 | Number | | 是 | | list | 菜品信息 | Object | | 是 | #### list #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | pid | ID | Number | | 是 | | shid | ID | Number | | 是 | | sortName | 分类名 | String | | 是 | | img | 菜品图片 | String | | 是 | | proName | 菜品名 | String | | 是 | | price | 价格 | String | | 是 | | proTotal | 销量 | String | | 是 | #### json示例 #### ```json { state:0, msg:"sucess", data:{ pid: "1", shid: "1", sortName: "新品❤上市", img: "https://wndoss.xlsea.cn/image/product/szxsdhgzj/20211028091056Aicy.png", proName: "全翅根人气炸鸡套餐（无饮品）", price: "23.88", proTotal: "42" } } ``` ### 2、添加分类 ### > 请求方式：POST > 请求地址：http://localhost:8080/product/type/add #### 请求参数 #### | 参数 | 是否必填 | 说明 | | --- | --- | --- | | username | 是 | 登录时商家的用户名 | | sortName | 是 | 分类名 | #### 返回参数 #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | state | 接口状态码 | Number | 成功（0），失败（1） | 是 | | msg | 接口信息 | String | 成功（sucess），失败（error） | 是 | #### json示例 #### ```json { state:0, msg:"sucess", } ``` ### 3、添加菜品 ### > 请求方式：POST > 请求地址：http://localhost:8080/product/add #### 请求参数 #### | 参数 | 是否必填 | 说明 | | --- | --- | --- | | username | 是 | 登录时商家的用户名 | | proName | 是 | 名称 | | price | 是 | 价格 | | img | 是 | 图片 | | sortName | 是 | 分类名称 | #### 返回参数 #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | state | 接口状态码 | Number | 成功（0），失败（1） | 是 | | msg | 接口信息 | String | 成功（sucess），失败（error） | 是 | #### json示例 #### ```json { state:0, msg:"sucess", } ``` ### 4、修改分类信息 ### > 请求方式：POST > 请求地址：http://localhost:8080/product/type/rev #### 请求参数 #### | 参数 | 是否必填 | 说明 | | --- | --- | --- | | shid | ID | Number | | 是 | | sortName | 是 | 分类名称 | #### 返回参数 #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | state | 接口状态码 | Number | 成功（0），失败（1） | 是 | | msg | 接口信息 | String | 成功（sucess），失败（error） | 是 | #### json示例 #### ```json { state:0, msg:"sucess", } ``` ### 5、修改菜品信息 ### > 请求方式：POST > 请求地址：http://localhost:8080/product/rev #### 请求参数 #### | 参数 | 是否必填 | 说明 | | --- | --- | --- | | pid | ID | Number | | 是 | | proName | 是 | 名称 | | price | 是 | 价格 | | img | 是 | 图片 | | sortName | 是 | 分类名称 | #### 返回参数 #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | state | 接口状态码 | Number | 成功（0），失败（1） | 是 | | msg | 接口信息 | String | 成功（sucess），失败（error） | 是 | #### json示例 #### ```json { state:0, msg:"sucess", } ``` ### 6、删除分类（若该分类下有菜品，删除失败并提示） ### > 请求方式：GET > 请求地址：http://localhost:8080/product/type/del #### 请求参数 #### | 参数 | 是否必填 | 说明 | | --- | --- | --- | | shid | 是 | ID | #### 返回参数 #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | state | 接口状态码 | Number | 成功（0），失败（1） | 是 | | msg | 接口信息 | String | 成功（sucess），失败（error） | 是 | #### json示例 #### ```json { state:0, msg:"sucess", } ``` ### 6、删除菜品 ### > 请求方式：GET > 请求地址：http://localhost:8080/product/del #### 请求参数 #### | 参数 | 是否必填 | 说明 | | --- | --- | --- | | pid | 是 | ID | #### 返回参数 #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | state | 接口状态码 | Number | 成功（0），失败（1） | 是 | | msg | 接口信息 | String | 成功（sucess），失败（error） | 是 | #### json示例 #### ```json { state:0, msg:"sucess", } ``` ---------- ## 订单页面（商家、管理员） ## ### 1、查询所有订单（分页）（根据订单日期段、店铺名、用户名、订单状态模糊查询） ### > 请求方式：GET > 请求地址：http://localhost:8080/order/list #### 请求参数 #### | 参数 | 是否必填 | 说明 | | --- | --- | --- | | page | 是 | 当前页数 | | limit | 是 | 每页显示的条数 | | time | 否 | 时间 | | username | 否 | 用户名 | | state | 否 | 状态 | #### 返回参数 #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | state | 接口状态码 | Number | 成功（0），失败（1） | 是 | | msg | 接口信息 | String | 成功（sucess），失败（error） | 是 | | data | 数据 | Object | | 是 | #### data #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | total | 查询到的总条数 | Number | | 是 | | list | 订单信息 | Object | | 是 | #### list #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | oid | ID | Number | | 是 | | time | 订单日期 | String | | 是 | | shopName | 店铺信息 | String | | 是 | | username | 用户名 | String | | 是 | | money | 金额 | Number | | 是 | | state | 订单状态 | String | | 是 | #### json示例 #### ```json { state:0, msg:"sucess", data:{ total: 20, list:[ { oid: 1, time: "2021-11-05 09:40:09", shopName: "三个先森的韩国炸鸡", username: "zhangsan", money: "26.38", state: "已支付", } ] } } ``` ### 2、删除订单 ### > 请求方式：GET > 请求地址：http://localhost:8080/order/del #### 请求参数 #### | 参数 | 是否必填 | 说明 | | --- | --- | --- | | oid | 是 | ID | #### 返回参数 #### | 字段 | 说明 | 类型 | 备注 | 是否必填 | | --- | --- | --- | --- | --- | | state | 接口状态码 | Number | 成功（0），失败（1） | 是 | | msg | 接口信息 | String | 成功（sucess），失败（error） | 是 | #### json示例 #### ```json { state:0, msg:"sucess", } ``` 最后修改：2023 年 03 月 01 日 © 允许规范转载 赞 0