Skip to content

5 News

新闻功能介绍

当用户访问首页时，首先需要加载不同分类的新闻数据，进而进入详情页查看具体新闻内容。

新闻模块主要实现以下功能:

  • 新闻分类获取
  • 新闻列表获取（支持分页和分类筛选）
  • 新闻详情获取
  • 浏览量统计

API接口介绍

1 获取新闻列表

功能描述：根据分类获取新闻列表，支持分页加载

请求方式：GET

接口地址：/api/news/list

请求参数：

参数名 类型 必填 描述
categoryId Number 是 新闻分类ID
page Number 否 页码，默认1
pageSize Number 否 每页条数，默认10

响应参数：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
{
  "code": 200,
  "message": "success",
  "data": {
    "list": [
      {
        "id": 1,
        "title": "新闻标题",
        "description": "新闻简介",
        "image": "图片URL",
        "author": "作者",
        "publishTime": "发布时间",
        "categoryId": 1,
        "views": 1000
      }
    ],
    "total": 100,
    "hasMore": true
  }
}

2 获取新闻详情

功能描述：根据新闻ID获取新闻详细内容

请求方式：GET

接口地址：/api/news/detail

请求参数：

参数名 类型 必填 描述
id Number 是 新闻ID

响应参数：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
{
  "code": 200,
  "message": "success",
  "data": {
    "id": 1,
    "title": "新闻标题",
    "content": "新闻详细内容",
    "image": "图片URL",
    "author": "作者",
    "publishTime": "发布时间",
    "categoryId": 1,
    "views": 1000,
    "relatedNews": [
      {
        "id": 2,
        "title": "相关新闻标题",
        "image": "图片URL"
      }
    ]
  }
}

3 获取新闻分类

功能描述：获取所有新闻分类

请求方式：GET

接口地址：/api/news/categories

请求参数：无

响应参数：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
{
  "code": 200,
  "message": "success",
  "data": [
    {
      "id": 1,
      "name": "头条"
    },
    {
      "id": 2,
      "name": "社会"
    }
  ]
}

1
{"code": 200,"message": "success","data": [{"id": 1,"name": "头条"}]}