每日一听

登录界面

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

请求参数

参数是否必填说明
adminIdID
img头像
username用户名
password密码
state状态

返回参数

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

json示例

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

4、修改管理员状态

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

请求参数

参数是否必填说明
adminIdID
state状态

返回参数

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

json示例

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

5、删除管理员

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

请求参数

参数是否必填说明
adminIdID

返回参数

字段说明类型备注是否必填
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

请求参数

参数是否必填说明
midID
password密码
img头像
phone手机号
state状态

返回参数

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

json示例

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

4、修改商家状态

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

请求参数

参数是否必填说明
midID
state状态

返回参数

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

json示例

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

5、删除商家

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

请求参数

参数是否必填说明
midID

返回参数

字段说明类型备注是否必填
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

请求参数

参数是否必填说明
uidID
img头像
password密码
phone手机号
stateName状态

返回参数

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

json示例

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

4、修改用户状态

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

请求参数

参数是否必填说明
uidID
state状态

返回参数

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

json示例

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

5、删除用户

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

请求参数

参数是否必填说明
uidID

返回参数

字段说明类型备注是否必填
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

请求参数

参数是否必填说明
ridID
password密码
phone手机号
img头像
state状态

返回参数

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

json示例

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

4、修改骑手状态

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

请求参数

参数是否必填说明
ridID
state状态

返回参数

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

json示例

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

5、删除骑手

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

请求参数

参数是否必填说明
ridID

返回参数

字段说明类型备注是否必填
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

请求参数

参数是否必填说明
sidID
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

请求参数

参数是否必填说明
sidID

返回参数

字段说明类型备注是否必填
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

请求参数

参数是否必填说明
shidID

返回参数

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

json示例

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

6、删除菜品

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

请求参数

参数是否必填说明
pidID

返回参数

字段说明类型备注是否必填
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

请求参数

参数是否必填说明
oidID

返回参数

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

json示例

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