加载中…
视频 video

模块说明

video 提供视频的列表与详情接口:列表支持分类筛选与年月归档,返回中带 pager 分页信息;详情含视频数据(播放地址等)、自定义字段与分类上下文。

鉴权级别:可选。

接口一览

方法 URL 鉴权 说明
GET /api/video 可选 视频列表 / 分类筛选 / 归档
GET /api/video/show/{id} 可选 视频详情

列表

请求参数

参数 必填 说明
id 否 分类 ID
category_slug 否 分类英文标识
year / month 否 按年月归档
page 否 页码,默认 1

响应

{
  "code": "OK",
  "message": "",
  "data": {
    "title": "视频中心",
    "category_id": 0,
    "video_list": [ { "id": 1, "name": "...", "thumb": "...", "...": "" } ],
    "video_category": [ { "id": 2, "name": "...", "children": [] } ],
    "cate_info": { "...": "当前分类详情" },
    "pager": { "page": 1, "page_size": 10, "record_count": 26, "page_count": 3 }
  },
  "errors": {},
  "request_id": "9f2a5c8e1b3d7f40"
}

详情

GET /api/video/show/4

{
  "code": "OK",
  "message": "",
  "data": {
    "title": "视频详情",
    "video": { "id": 4, "name": "...", "content": "<p>……</p>", "click": 120, "...": "" },
    "defined": { "...": "自定义字段" },
    "cate_info": { "...": "所属分类详情" }
  },
  "errors": {},
  "request_id": "9f2a5c8e1b3d7f40"
}

注意事项

  • 列表键为 video_list、分类树键为 video_category、详情键为 video;
  • 列表返回的 pager 为分页信息(页码/每页/总数),可直接渲染分页器;
  • 详情每次读取递增 click。
添加日期:2026-10-06