视频密码验证接口

接口说明

验证加密视频的访问密码是否正确。用于在访问加密视频前进行密码验证。

  • 接口URL: /api/videos/password-verify
  • 请求方法: POST
  • 权限要求: 无需登录即可访问

请求参数

参数名 类型 必填 说明 示例值
id number 是 视频ID 1
password string 是 视频访问密码 "123456"

响应结构

typescript 复制代码 
interface Response {
  code: number;      // 状态码
  message: string;   // 响应消息
  data: null;        // 无返回数据
}

响应示例

验证成功

json 复制代码 
{
  "code": 0,
  "message": "密码正确",
  "data": null
}

验证失败

json 复制代码 
{
  "code": 401,
  "message": "密码错误",
  "data": null
}

特殊说明

使用场景

  • 在访问加密视频前，可以先调用此接口验证密码
  • 验证通过后，可以使用相同的密码调用视频详情接口
  • 此接口不会返回视频信息，仅验证密码是否正确

错误码说明

错误码 说明 处理建议
0 成功 密码正确，可以访问视频
400 参数错误 检查ID和密码是否都已提供
401 密码错误 检查密码是否正确
404 视频不存在 检查视频ID是否正确

调用示例

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

const result = await response.json();
if (result.code === 0) {
  // 密码正确，可以访问视频
  console.log('密码验证通过');
} else {
  // 密码错误或其他错误
  console.error(result.message);
}