加载中…
图片展示 onepic

模块说明

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。
添加日期:2026-10-06