模块说明
onepic 是"单图展示"模块(一张主图配说明,适用于成果展示、横滑图片位等):列表分页返回并附带 image_list 图片合集;详情返回单条记录。
鉴权级别:可选。
接口一览
| 方法 | URL | 鉴权 | 说明 |
|---|---|---|---|
| GET | /api/onepic |
可选 | 列表 |
| GET | /api/onepic/show/{id} |
可选 | 详情 |
列表
请求参数
| 参数 | 必填 | 说明 |
|---|---|---|
page |
否 | 页码,默认 1 |
pageSize |
否 | 每页数量(0=用后台默认) |
响应
{
"code": "OK",
"message": "",
"data": {
"title": "图片展示",
"onepic_list": [ { "id": 1, "name": "...", "image": "...", "...": "" } ],
"image_list": [ "a.png", "b.png" ],
"pager": { "page": 1, "page_size": 10, "record_count": 7, "page_count": 1 }
},
"errors": {},
"request_id": "9f2a5c8e1b3d7f40"
}
详情
GET /api/onepic/show/1
{
"code": "OK",
"message": "",
"data": {
"title": "记录名",
"onepic": { "id": 1, "name": "...", "image": "...", "content": "<p>……</p>", "...": "" }
},
"errors": {},
"request_id": "9f2a5c8e1b3d7f40"
}
注意事项
- 列表键为
onepic_list、详情键为onepic,附加image_list为当前页图片合集; - 详情 ID 无效返回
422,记录不存在返回404。