模块说明
article 提供文章（新闻/资讯）的列表与详情接口：列表支持分类筛选与按年月归档；详情包含已渲染的正文、自定义字段与评论数据，并自动累计阅读量。
鉴权级别：可选（匿名可读，登录后返回中可能带个性化字段）。
接口一览
| 方法 |
URL |
鉴权 |
说明 |
| GET |
/api/article |
可选 |
文章列表 / 分类筛选 / 日期归档 |
| GET |
/api/article/show/{id} |
可选 |
文章详情 |
列表
请求参数
| 参数 |
必填 |
说明 |
id |
否 |
分类 ID（不传=全部） |
category_slug |
否 |
分类英文标识（与 id 二选一） |
year |
否 |
按年份归档（如 2026） |
month |
否 |
按月份归档（需与 year 同传，如 01） |
page |
否 |
页码，默认 1 |
GET /api/article?id=3&page=2
GET /api/article?year=2026&month=01
响应
{
"code": "OK",
"message": "",
"data": {
"title": "公司动态",
"category_id": 3,
"article_list": [ { "id": 1, "title": "...", "thumb": "...", "add_time": "...", "...": "" } ],
"article_category": [ { "id": 3, "name": "公司动态", "children": [] } ],
"cate_info": { "id": 3, "name": "公司动态", "keywords": "...", "description": "...", "url": "..." }
},
"errors": {},
"request_id": "9f2a5c8e1b3d7f40"
}
| 字段 |
说明 |
title |
页面标题（分类名或"文章"） |
category_id |
当前分类（归档时归 0） |
article_list |
文章列表 |
article_category |
分类树（含子级），可直接渲染筛选器 |
cate_info |
当前分类详情（名称/SEO/URL） |
详情
请求参数
| 参数 |
必填 |
说明 |
id（路径或参数） |
是 |
文章 ID，如 /api/article/show/12 |
category_slug / slug |
否 |
替代 ID 的定位方式 |
响应
{
"code": "OK",
"message": "",
"data": {
"defined": { "作者": "编辑部" },
"title": "文章详情",
"comment": { "...": "评论数据（评论模块已启用时返回）" },
"article": {
"id": 12,
"title": "...",
"content": "<p>……（已渲染 HTML）</p>",
"click": 235,
"...": ""
}
},
"errors": {},
"request_id": "9f2a5c8e1b3d7f40"
}
| 字段 |
说明 |
defined |
自定义字段（后台"文章自定义"配置） |
comment |
评论数据（评论模块启用时才有；含评论列表） |
article.content |
已渲染正文 HTML，直接注入展示 |
article.click |
阅读量（本次访问后的最新值） |
注意事项
- 分类定位支持「ID / category_slug」，详情定位支持「ID / category_slug + slug」，两种方式错误时返回
422；
year+month 归档与分类筛选互斥：传归档时 category_id 归 0；- 详情每次读取递增
click；
- 分页步长由后台
pagination.article 配置决定。