每日一听

[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示例

{
    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示例

{
    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示例

{
    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示例

{
    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示例

{
    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

字段说明类型备注是否必填
adminIdIDNumber 是
img头像String是
username用户名String 是
password密码String 是
stateName状态String 是

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示例

{
    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示例

{
    state:0,
    msg:"sucess",
}

4、修改管理员状态

请求方式:POST
请求地址:http://localhost:8080/admin/revState

请求参数

参数是否必填说明
adminId是ID
state是状态

返回参数

字段说明类型备注是否必填
state接口状态码Number成功(0),失败(1)是
msg接口信息String成功(sucess),失败(error)是

json示例

{
    state:0,
    msg:"sucess",
}

5、删除管理员

请求方式:GET
请求地址:http://localhost:8080/admin/del

请求参数

参数是否必填说明
adminId是ID

返回参数

字段说明类型备注是否必填
state接口状态码Number成功(0),失败(1)是
msg接口信息String成功(sucess),失败(error)是

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

字段说明类型备注是否必填
midIDNumber 是
username用户名String 是
password密码String 是
img头像String是
name商家名String 是
shopName店铺名String商家名下的店铺是
sex性别String 是
phone手机号String 是
balance余额Number 是
stateName状态String 是

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示例

{
    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示例

{
    state:0,
    msg:"sucess",
}

4、修改商家状态

请求方式:POST
请求地址:http://localhost:8080/merchant/revState

请求参数

参数是否必填说明
mid是ID
state是状态

返回参数

字段说明类型备注是否必填
state接口状态码Number成功(0),失败(1)是
msg接口信息String成功(sucess),失败(error)是

json示例

{
    state:0,
    msg:"sucess",
}

5、删除商家

请求方式:GET
请求地址:http://localhost:8080/merchant/del

请求参数

参数是否必填说明
mid是ID

返回参数

字段说明类型备注是否必填
state接口状态码Number成功(0),失败(1)是
msg接口信息String成功(sucess),失败(error)是

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

字段说明类型备注是否必填
uidIDNumber 是
img头像String 是
username用户名String 是
password密码String 是
sex性别String 是
phone手机号String 是
balance余额Number 是
vip会员信息String会员(开通时间 至 结束时间),非会员(非会员)是
stateName状态String 是

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示例

{
    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示例

{
    state:0,
    msg:"sucess",
}

4、修改用户状态

请求方式:POST
请求地址:http://localhost:8080/user/revState

请求参数

参数是否必填说明
uid是ID
state是状态

返回参数

字段说明类型备注是否必填
state接口状态码Number成功(0),失败(1)是
msg接口信息String成功(sucess),失败(error)是

json示例

{
    state:0,
    msg:"sucess",
}

5、删除用户

请求方式:GET
请求地址:http://localhost:8080/user/del

请求参数

参数是否必填说明
uid是ID

返回参数

字段说明类型备注是否必填
state接口状态码Number成功(0),失败(1)是
msg接口信息String成功(sucess),失败(error)是

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

字段说明类型备注是否必填
ridIDNumber 是
username用户名String 是
password密码String 是
img头像String 是
name骑手名String 是
sex性别String 是
phone手机号String 是
balance余额Number 是
stateName状态String 是

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示例

{
    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示例

{
    state:0,
    msg:"sucess",
}

4、修改骑手状态

请求方式:POST
请求地址:http://localhost:8080/rider/revState

请求参数

参数是否必填说明
rid是ID
state是状态

返回参数

字段说明类型备注是否必填
state接口状态码Number成功(0),失败(1)是
msg接口信息String成功(sucess),失败(error)是

json示例

{
    state:0,
    msg:"sucess",
}

5、删除骑手

请求方式:GET
请求地址:http://localhost:8080/rider/del

请求参数

参数是否必填说明
rid是ID

返回参数

字段说明类型备注是否必填
state接口状态码Number成功(0),失败(1)是
msg接口信息String成功(sucess),失败(error)是

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

字段说明类型备注是否必填
sidIDNumber 是
img店铺头像String 是
shopName店铺名String 是
shopInfo店铺简介String 是
shopAddress店铺地址String 是
name商家名String 是

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示例

{
    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示例

{
    state:0,
    msg:"sucess",
}

4、删除店铺

请求方式:GET
请求地址:http://localhost:8080/shop/del

请求参数

参数是否必填说明
sid是ID

返回参数

字段说明类型备注是否必填
state接口状态码Number成功(0),失败(1)是
msg接口信息String成功(sucess),失败(error)是

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

字段说明类型备注是否必填
pidIDNumber 是
shidIDNumber 是
sortName分类名String 是
img菜品图片String 是
proName菜品名String 是
price价格String 是
proTotal销量String 是

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示例

{
    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示例

{
    state:0,
    msg:"sucess",
}

4、修改分类信息

请求方式:POST
请求地址:http://localhost:8080/product/type/rev

请求参数

参数是否必填说明
shidIDNumber 是
sortName是分类名称

返回参数

字段说明类型备注是否必填
state接口状态码Number成功(0),失败(1)是
msg接口信息String成功(sucess),失败(error)是

json示例

{
    state:0,
    msg:"sucess",
}

5、修改菜品信息

请求方式:POST
请求地址:http://localhost:8080/product/rev

请求参数

参数是否必填说明
pidIDNumber 是
proName是名称
price是价格
img是图片
sortName是分类名称

返回参数

字段说明类型备注是否必填
state接口状态码Number成功(0),失败(1)是
msg接口信息String成功(sucess),失败(error)是

json示例

{
    state:0,
    msg:"sucess",
}

6、删除分类(若该分类下有菜品,删除失败并提示)

请求方式:GET
请求地址:http://localhost:8080/product/type/del

请求参数

参数是否必填说明
shid是ID

返回参数

字段说明类型备注是否必填
state接口状态码Number成功(0),失败(1)是
msg接口信息String成功(sucess),失败(error)是

json示例

{
    state:0,
    msg:"sucess",
}

6、删除菜品

请求方式:GET
请求地址:http://localhost:8080/product/del

请求参数

参数是否必填说明
pid是ID

返回参数

字段说明类型备注是否必填
state接口状态码Number成功(0),失败(1)是
msg接口信息String成功(sucess),失败(error)是

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

字段说明类型备注是否必填
oidIDNumber 是
time订单日期String 是
shopName店铺信息String 是
username用户名String 是
money金额Number 是
state订单状态String 是

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示例

{
    state:0,
    msg:"sucess",
}
最后修改:2023 年 03 月 01 日
温柔的好天气总是和我一样,帅的鸭皮!