接口咨询 020-3886 5521

综艺纪录采集接口

综艺和纪录片的结构跟影视剧不一样:一个按栏目走,一个按系列走。综艺纪录采集接口用栏目名做一级索引,单集带时长与嘉宾,纪录片则按季与主题归集,两类数据分表输出,互不干扰。

演播室内景中的摄像机、灯架与背景板

接口参数

接口版本MacCMS V10,综艺走 type_id 独立分支,纪录片走 doc 分支
输出格式JSON(默认)、XML 可选;单页 20 条,支持按栏目 t 参数过滤
单片库配额标准套餐 3.6 万条(综艺 2.1 万、纪录片 1.5 万)
字段覆盖38 项,含 vod_duration(单集时长)、vod_actor(嘉宾)、vod_area(制作地区)
兼容性苹果CMS V10、自研采集器;栏目名含空格时按 URL 编码传参
部署方式公网直连,栏目级订阅可开专属入口
数据合规栏目与单集元数据,不含完整节目视频文件
SLA 响应栏目断更 12 小时以上触发告警,工作日 2 小时内回复
更新间隔在播综艺 30 分钟一轮,纪录片 12 小时一轮

参数按 综艺纪录采集接口 的交付口径写,实际配额以控制台显示为准。

三个实际使用场合

周更综艺的排期表

一档周更综艺每周五 20:00 上线。接口按 vod_time 返回单集,取最近 3 期生成“最近三期”区块,编辑不用每周手动换封面。

纪录片主题合集

自然类纪录片分散在 6 个系列里。按 vod_series 归集后做成“地球”“海洋”“极地”三个专题,每个专题 8 到 12 部,链接一次生成。

嘉宾检索页

把 vod_actor 拆成数组建索引,用户点嘉宾名能看到他参加过的所有期,单页最多 40 条,超出走分页。

选型建议

做综艺站的人常忽略时长字段,结果列表页无法标注“52 分钟正片”还是“8 分钟花絮”。如果站点有“正片/花絮”分区,必须用这一条;纯纪录片站可以只要 doc 分支,配额能压到 1.5 万条,成本下降三分之一。

客户为什么选这一条,而不是隔壁那家

三条可验证的差异

  • 栏目与单集两级结构:栏目单独一条父记录,单集挂在其下,做栏目页不用自己 group by。
  • 时长带单位整数:vod_duration 返回分钟整数,另附 seconds 字段,前端展示不用再做字符串截取。
  • 嘉宾字段是数组:vod_actor 用竖线分隔,避免中文逗号与英文逗号混用导致的拆分错误。

交付周期与售后条款

阶段时间与内容
测试 key当天开通,含 300 次试调用
栏目映射1 至 2 个工作日,交付栏目对照表
正式上线第 3 个工作日,旧数据可并行导入

栏目改名导致的分类漂移,7 天内免费重做一次映射;接口不可用超过 2 小时按比例返还当月配额;不提供节目版权相关的任何承诺或背书。

这一类里的其他接口

相关现场记录:骨干光缆割接:跨省首帧从3.1秒、核心交换机换新:一台 48 口设。分类与字段口径见综合影视接口,完整字段说明在对接文档。

常被问到的问题

综艺的花絮算独立条目吗

算,用 vod_remarks 标“花絮”,可以和正片分开过滤。

纪录片有解说版本标记吗

有,vod_lang 会标“国语解说”“原声中字”两种。

能只订一个栏目吗

能,按栏目订阅的配额是标准套餐的三分之一。