视频详情接口

接口说明

获取单个视频的详细信息。支持加密视频的访问，需要提供正确的密码。

  • 接口URL: /api/videos/show
  • 请求方法: POST
  • 权限要求: 支持未登录访问，但登录后可查看更多信息

请求参数

参数名 类型 必填 说明 示例值
video_id number 是 视频ID 1
video_password string 否 视频访问密码，加密视频必填 "123456"

响应结构

typescript 复制代码 
interface Response {
  code: number;      // 状态码
  message: string;   // 响应消息
  data?: {
    video_id: number;        // 视频ID
    video_title: string;     // 视频标题
    video_text: string;      // 视频描述
    video_date: string;      // 发布日期
    video_private: number;   // 是否私密(0:否, 1:是)
    video_password?: string; // 访问密码(加密视频才有)
    video_url: string;      // 视频URL
    video_cover: string;    // 视频封面
    vi_coll_id: number;     // 分类ID
  };
}

响应示例

普通视频

json 复制代码 
{
  "code": 0,
  "message": "success",
  "data": {
    "video_id": 1,
    "video_title": "示例视频",
    "video_text": "这是一个示例视频的完整描述",
    "video_date": "2024-01-01",
    "video_private": 0,
    "video_url": "https://example.com/video.mp4",
    "video_cover": "https://example.com/cover.jpg",
    "vi_coll_id": 1
  }
}

加密视频(密码错误)

json 复制代码 
{
  "code": 401,
  "message": "需要密码访问",
  "data": {
    "video_id": 2,
    "video_title": "加密视频",
    "video_text": "这个视频需要密码才能访问",
    "video_date": "2024-01-01",
    "video_private": 0,
    "video_password": "******",
    "vi_coll_id": 1
  }
}

特殊说明

访问控制

  • 私密视频只有登录用户可以访问
  • 加密视频需要提供正确的密码才能查看完整信息
  • 管理员登录后可以查看所有视频的完整信息

内容处理

  • 视频描述不会被截断，返回完整内容
  • 加密视频在密码错误时，敏感信息会被隐藏

错误码说明

错误码 说明 处理建议
0 成功 -
401 需要密码访问 提供正确的访问密码
404 视频不存在 检查视频ID是否正确
500 服务器错误 请联系管理员

调用示例

普通视频访问

typescript 复制代码 
const response = await fetch('/api/videos/show', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    video_id: 1
  })
});

加密视频访问

typescript 复制代码 
const response = await fetch('/api/videos/show', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    video_id: 2,
    video_password: "123456"
  })
});