剧集频道采集接口
剧集频道采集接口把“剧”和“集”拆成两级:一部剧一条主记录,下面挂分季与分集,集数序号单独成字段。追更类站点最怕的第 5 集变第 3 集,在这里由 vod_serial 与 episode 双重排序解决。
接口参数
| 接口版本 | MacCMS V10,/api/provide/vod/,detail 模式返回分集列表 |
|---|---|
| 输出格式 | JSON 与 XML,分集列表在 vod_play_url 内以 # 分隔,播放组用 $$$ 分组 |
| 单片库配额 | 标准套餐 9 万部剧(含分集),扩容套餐 22 万部 |
| 字段覆盖 | 41 项,含 vod_serial(集数)、vod_total、vod_isend(是否完结)、vod_area |
| 兼容性 | 苹果CMS V10 播放器、DPlayer、视频云播放器均可直接解析播放串 |
| 部署方式 | 公网直连;高频追更场景可开增量接口,只回 2 小时内变更 |
| 数据合规 | 分集元数据与播放地址,不缓存视频切片 |
| SLA 响应 | 追更延迟超过 30 分钟按工单升级,24 小时内定位 |
| 更新间隔 | 在更剧集 10 分钟一轮扫描,完结剧 6 小时一轮 |
参数按 剧集频道采集接口 的交付口径写,实际配额以控制台显示为准。
三个实际使用场合
在更剧的“今日更新”列表
一个做美剧的站点每天 20:00 更新首页。接口用增量模式只返回 2 小时内变更的剧,返回体从 18MB 降到 1.2MB,采集脚本跑完从 4 分钟缩到 20 秒。
分季剧集的选集面板
《某某》拍到第 4 季,前 3 季各有 10 到 12 集。vod_play_url 按季分组输出,播放器读到的集数顺序和官方一致,用户不会看到第 4 季第 1 集混在第 3 季末尾。
完结剧的批量归档
把 vod_isend 为 1 的剧一次性归档到“完结剧场”分类,按 vod_total 判断是否缺集,缺集的单独出一张核对表给运营。
选型建议
追更型站点选剧集口,不要用综合包凑。判断标准很简单:如果首页 60% 以上是“更新到第几集”的内容,就需要分集字段;如果只是做片库检索,综合包够用。另一个分界线是集数规模,超过 20 万集以后必须用增量接口,全量拉一次的成本会超过带宽预算。
客户为什么选这一条,而不是隔壁那家
三条可验证的差异
- 分集排序用双字段校验:vod_serial 与 episode 同时返回,任一为空时用另一个兜底,避免第 0 集。
- 完结标记是布尔值:vod_isend 只回 0 或 1,不用判断“完结”“已完结”“全”这类自由文本。
- 增量接口独立计费:增量调用按 0.3 次计,全量按 1 次计,追更站每月能省一半配额。
交付周期与售后条款
| 阶段 | 时间与内容 |
|---|---|
| 测试 key | 当天开通,含 300 次试调用 |
| 分集结构核对 | 2 个工作日,抽 30 部剧逐集比对 |
| 正式切换 | 第 4 个工作日,保留 7 天双跑 |
分集错位属于一级问题,工单提交后 4 小时内给结论;接口字段变更提前 7 天公告并保留旧版 30 天;不承接播放器二次开发,但提供播放串格式说明。
这一类里的其他接口
相关现场记录:骨干光缆割接:跨省首帧从3.1秒、核心交换机换新:一台 48 口设。分类与字段口径见综合影视接口,完整字段说明在对接文档。
常被问到的问题
一部剧最多支持多少集
单剧 2000 集以内正常返回,超过会分页,用 pg 参数取。
分集标题能自定义吗
不能改源数据,但 vod_play_url 里的集名可以直接在采集端替换。
完结剧还会再更新吗
会,修复片源或补清晰度时仍会变更,增量接口照常推送。