视频内容原数据获取接口开发指南
接口概述
本接口支持通过视频唯一标识码(bvid)或数字编号(aid)获取视频基础信息、创作者数据、互动指标等内容。采用RESTful设计规范,返回标准JSON格式数据。
基础URL
text
Copy Code
https://api.example.com/x/web-interface/view
点击获取key和secret
请求方法
GET
认证机制
调用接口需在Header附加有效认证凭证:
http
Copy Code
GET /x/web-interface/view?aid=123456 HTTP/1.1
Cookie: SESSDATA=your_session_key
或使用OAuth2授权:
http
Copy Code
Authorization: Bearer your_access_token
请求参数
参数名 类型 必填 说明
aid int 否 视频数字ID(与bvid二选一)
bvid string 否 加密视频标识符(推荐使用)
响应数据结构
json
Copy Code
{
"code": 0,
"data": {
"basic": {
"title": "【技术教程】API开发全流程解析",
"desc": "本视频详细讲解开放接口开发规范...",
"duration": 1560,
"pubtime": 1672502400
},
"owner": {
"mid": 12345678,
"name": "技术开发部",
"fans": 284500
},
"stat": {
"view": 158432,
"danmaku": 8921,
"reply": 3456,
"coin": 2845
},
"pages": [
{
"cid": 78901234,
"part": "第一章 接口鉴权"
}
]
}
}
错误代码示例
错误码 含义 解决方案
-403 访问权限不足 检查认证信息有效性
-404 视频不存在 验证视频ID准确性
62002 服务端限流 降低请求频率至30次/分钟
最佳实践建议
缓存策略:视频基础信息建议缓存12小时,统计数据建议缓存15分钟
异常处理:对retry-after响应头进行识别处理
字段验证:验证data.pages.cid存在性后再请求视频流地址
用户隐私:不得存储用户昵称、头像等个人信息
开发注意事项
遵循平台《开放接口服务协议》V3.2版本规范
异步任务建议使用X-UposHeader指定CDN节点
4K分辨率视频需在Header添加"x-high-quality": 1标识
完整技术文档请参考平台开发者门户 » 内容接口 » 视频基础信息获取模块。
本指南不涉及具体平台反爬机制及隐私数据获取方式,所有接口调用需遵守平台开发者协议及国家相关法律法规。