接口咨询 020-3886 5521

剧集频道采集接口

剧集频道采集接口把“剧”和“集”拆成两级:一部剧一条主记录,下面挂分季与分集,集数序号单独成字段。追更类站点最怕的第 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 里的集名可以直接在采集端替换。

完结剧还会再更新吗

会,修复片源或补清晰度时仍会变更,增量接口照常推送。