通知公告接口

接口列表

接口	方法	说明
/api/v1/notices	GET	获取通知列表
/api/v1/notices/{id}	GET	获取通知详情
/api/v1/notices	POST	发布通知
/api/v1/notices/{id}	PUT	修改通知
/api/v1/notices/{id}	DELETE	删除通知
/api/v1/notices/{id}/read	POST	标记为已读

获取通知列表

GET /api/v1/notices?pageNum=1&pageSize=10&type=1&status=1
Authorization: Bearer {accessToken}

查询参数：

参数	类型	必填	说明
pageNum	number	❌	页码（默认 1）
pageSize	number	❌	每页条数（默认 10）
title	string	❌	标题（模糊查询）
type	number	❌	类型（1 通知，2 公告）
status	number	❌	状态（1 正常，0 关闭）

响应示例：

{
  "code": "00000",
  "message": "成功",
  "data": {
    "total": 12,
    "list": [
      {
        "id": 1,
        "title": "系统升级通知",
        "content": "系统将于本周六 22:00 进行升级...",
        "type": 1,
        "status": 1,
        "createTime": "2024-01-15 10:30:00",
        "createBy": "管理员"
      }
    ]
  }
}

获取通知详情

GET /api/v1/notices/1
Authorization: Bearer {accessToken}

响应示例：

{
  "code": "00000",
  "message": "成功",
  "data": {
    "id": 1,
    "title": "系统升级通知",
    "content": "系统将于本周六 22:00 进行升级...",
    "type": 1,
    "status": 1,
    "createTime": "2024-01-15 10:30:00",
    "createBy": "管理员",
    "readCount": 156,
    "isRead": true
  }
}

发布通知

POST /api/v1/notices
Authorization: Bearer {accessToken}
Content-Type: application/json

{
  "title": "系统升级通知",
  "content": "系统将于本周六 22:00 进行升级维护...",
  "type": 1,
  "status": 1
}

标记为已读

POST /api/v1/notices/1/read
Authorization: Bearer {accessToken}

通知类型

值	说明
1	通知
2	公告

通知状态

值	说明
1	正常（显示）
0	关闭（隐藏）

权限要求

操作	权限标识
查看列表	sys:notice:list
发布通知	sys:notice:add
修改通知	sys:notice:edit
删除通知	sys:notice:delete

实时推送

启用 SSE 后，新通知会实时推送到前端：

// SSE 事件格式
{
  event: 'notice',
  data: {
    id: 1,
    title: '系统升级通知',
    type: 1
  }
}