Banner 管理

Banner 管理提供系统横幅内容的完整 CRUD 操作。

功能说明

• Banner 分页查询
• Banner 新增
• Banner 修改
• Banner 删除（支持批量）
• Banner 详情查看
• 数据导出（Excel）
• 导入模板下载

API 接口

所有接口均需要 JWT 权限校验。

方法	路径	权限标识	说明
GET	/api/v1/sys/banner/page	sys:banner:page	获取 Banner 分页
POST	/api/v1/sys/banner/create	sys:banner:create	添加 Banner
POST	/api/v1/sys/banner/modify	sys:banner:modify	编辑 Banner
POST	/api/v1/sys/banner/remove	sys:banner:remove	删除 Banner
GET	/api/v1/sys/banner/detail	sys:banner:detail	获取 Banner 详情
GET	/api/v1/sys/banner/export	sys:banner:export	导出 Banner 数据
GET	/api/v1/sys/banner/template	sys:banner:template	下载导入模板

请求参数

分页查询

GET /api/v1/sys/banner/page?current=1&size=10

新增/编辑

POST /api/v1/sys/banner/create
{
  "title": "Banner标题",
  "image": "图片URL",
  "url": "跳转链接",
  "position": "home",
  "sort_order": 1,
  "status": 1
}

删除

POST /api/v1/sys/banner/remove
{
  "ids": ["1234567890", "0987654321"]
}

返回结构

分页返回

{
  "code": 200,
  "success": true,
  "message": "请求成功",
  "data": {
    "records": [...],
    "total": 100,
    "page": 1,
    "size": 10,
    "pages": 10
  }
}

权限装饰器示例

from fastapi import APIRouter, Request
from core.auth.decorator import HeiCheckPermission

router = APIRouter()

@router.get("/api/v1/sys/banner/page")
@HeiCheckPermission("sys:banner:page")
async def page(request: Request, current: int = 1, size: int = 10):
    # 业务逻辑
    pass