模块说明
gallery 提供图集的列表与详情接口：列表支持分类筛选、年月归档与自定义每页数量（pageSize），返回 pager 分页信息；详情含图集图片数据。
鉴权级别：可选。
接口一览
| 方法 | URL | 鉴权 | 说明 |
|---|---|---|---|
| GET | /api/gallery |
可选 | 图集列表 / 分类筛选 / 归档 |
| GET | /api/gallery/show/{id} |
可选 | 图集详情 |
列表
请求参数
| 参数 | 必填 | 说明 |
|---|---|---|
id |
否 | 分类 ID |
category_slug |
否 | 分类英文标识 |
year / month |
否 | 按年月归档 |
page |
否 | 页码，默认 1 |
pageSize |
否 | 每页数量（覆盖后台默认值，0=用默认） |
响应
{
"code": "OK",
"message": "",
"data": {
"title": "图集",
"category_id": 0,
"gallery_list": [ { "id": 1, "name": "...", "thumb": "...", "...": "" } ],
"gallery_category": [ { "id": 2, "name": "...", "children": [] } ],
"cate_info": { "...": "当前分类详情" },
"pager": { "page": 1, "page_size": 10, "record_count": 35, "page_count": 4 }
},
"errors": {},
"request_id": "9f2a5c8e1b3d7f40"
}详情
GET /api/gallery/show/2
{
"code": "OK",
"message": "",
"data": {
"title": "图集详情",
"gallery": { "id": 2, "name": "...", "content": "<p>……</p>", "...": "含图片列表" },
"defined": { "...": "自定义字段" },
"cate_info": { "...": "所属分类详情" }
},
"errors": {},
"request_id": "9f2a5c8e1b3d7f40"
}注意事项
- 列表键为
gallery_list、分类树键为gallery_category、详情键为gallery； - 归档标题形态：传
year/month时title为"YYYY年MM月"文本； pageSize仅影响单次返回数量，不改变总数量语义。