内容管理

VodController 提供视频内容的查询、推荐等级调整与删除能力。所有接口均受 JwtGuard + RoleGuard 保护，需要携带有效的 Bearer Token。

查询视频列表

• Method：GET
• Path：/vod

Query 参数

参数	类型	必填	说明
name	string	✗	模糊搜索视频名称。
level	number	✗	推荐等级，缺省为全部。
status	0 | 1	✗	发布状态，默认同时查询上下架。
pageNo	number	✗	页码，默认为 1。
pageSize	number	✗	每页条数，默认为 10。

响应

{
  "code": 0,
  "data": {
    "pageData": [
      {
        "vodId": 216862,
        "vodName": "三更雪",
        "vodPic": "https://cdn.example/poster.jpg",
        "vodRemarks": "更新至第08集",
        "vodLevel": 10,
        "vodStatus": 1,
        "vodTime": 1759114083
      }
    ],
    "total": 120
  },
  "message": "OK"
}

该接口分两步查询：先分页获取 ID，再查询详情，保证排序一致。新增字段时需同步更新 Service 中的 select。

查询分类

• Method：GET
• Path：/vod/type

Query 参数

参数	类型	必填	说明
typePid	number	✗	父级分类 ID。缺省返回所有分类。

响应为数组，每项包含 typeId、typeName。

修改推荐等级

• Method：POST
• Path：/vod/updateVodLevelByVodId

请求体

字段	类型	必填	说明
vodId	number	✓	视频 ID。
vodLevel	number	✓	推荐等级，建议与首页 hotLevel、bannerLevel 协同维护。

成功返回 "修改成功"。若视频不存在，抛出 ERR_10000。

删除视频

• Method：POST
• Path：/vod/deleteVodByVodId

请求体

字段	类型	必填	说明
vodId	number	✓	视频 ID。

成功返回 "删除成功"。若记录不存在，同样会返回 ERR_10000。删除后请同步清理移动端缓存（如首页 Redis）。

以上两个写操作均无事务保护，建议前端在批量操作时按 ID 序列逐条执行，并在失败时给出明确提示。