新闻公告 API 文档

完整的新闻公告查询接口文档，支持列表查询、详情查询和多种筛选条件

获取新闻公告列表

查询新闻公告列表，支持分页、分类筛选和关键词搜索

GET/api/news

请求参数

pagenumber

limitnumber

type_idnumber

keywordstring

响应示例

{
  "success": true,
  "code": 200,
  "message": "查询成功",
  "data": {
    "list": [
      {
        "id": 1,
        "title": "系统维护通知",
        "content": "系统将于...",
        "create_time": 1640995200,
        "create_time_formatted": "2022-01-01 12:00:00",
        "read": 100
      }
    ],
    "pagination": {
      "current_page": 1,
      "total": 10
    }
  }
}

响应字段说明

字段名	类型	说明
id	number	新闻ID
title	string	新闻标题
content	string	新闻内容
keywords	string	关键词
read	number	阅读量
create_time	number	创建时间（Unix时间戳）
create_time_formatted	string	格式化的创建时间
update_time_formatted	string	格式化的更新时间

获取新闻详情

根据新闻ID查询详细信息，自动增加阅读量

GET/api/news/{id}

路径参数

id*

number

新闻ID，必填参数

响应示例

{
  "success": true,
  "code": 200,
  "message": "查询成功",
  "data": {
    "id": 1,
    "title": "系统维护通知",
    "content": "详细的维护内容...",
    "keywords": "维护,通知",
    "img": "news_image.jpg",
    "read": 101,
    "create_time_formatted": "2022-01-01 12:00:00"
  }
}

API 测试示例

使用以下示例 URL 快速测试新闻公告 API 功能

获取新闻列表

GET /api/news?page=1&limit=10

关键词搜索

GET /api/news?keyword=维护&type_id=1

获取新闻详情

GET /api/news/1

分类筛选

GET /api/news?type_id=2&page=1