视频内容原数据获取接口开发指南

210 阅读2分钟

接口概述

本接口支持通过视频唯一标识码(bvid)或数字编号(aid)获取视频基础信息、创作者数据、互动指标等内容。采用RESTful设计规范,返回标准JSON格式数据。

基础URL text Copy Code api.example.com/x/web-inter…

0097196fbbaa42a2adfdae25039c6a5f.png 点击获取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标识

完整技术文档请参考平台开发者门户 » 内容接口 » 视频基础信息获取模块。

本指南不涉及具体平台反爬机制及隐私数据获取方式,所有接口调用需遵守平台开发者协议及国家相关法律法规。