分类节点,三级路径可直接生成栏目页
输出字段,元数据与播放地址分开给
回源线路,主备切换平均 1.2 秒
跨省首帧实测中位数,取样 120 部片
四组接口,按你站点的内容结构选
片库型站点用综合口,追更型用剧集与短剧口,只缺播放能力的直接用解析转码。
综合影视接口
电影、剧集、综艺、纪录片四个片库口,按 MacCMS V10 的 vod 结构输出,一次对接拿到片名、分类、简介、封面与播放地址。
- 电影按年份、地区、语言三维切分
- 剧集保留分季分集与集数序号
- 综艺按栏目归集,单集带时长
短剧动漫接口
竖屏短剧、番剧、AI 漫剧三条产线,单集时长、合集顺序、配音轨与画面比例单独标注,适配 9:16 与 16:9 两种放映容器。
- 竖屏短剧单集 60 至 90 秒
- 番剧按季度与集数归集
- 漫剧标注配音轨与章节
播放解析转码
把采集回来的播放串变成能播的流:HLS 解析、多线路切换、按档位切片转码,三段分开部署,哪一段出问题都能单独回滚。
- 遵循 RFC 8216 的 HLS 解析
- 线路失败 3 次自动换源
- 720P 至 4K 四档转码
建站对接服务
已经有机器的站长看这一段:CMS 对接、插件部署、换域名换源,三个动作都按工单走,交付时给配置记录和回滚步骤。
- 苹果CMS V10 分类绑定与定时采集
- 插件包上传即用,含日志面板
- 换源保留旧库,可随时切回
接口字段对照表:同行给什么,我们给什么
这张表是我们自己对接时踩坑踩出来的。左边是 MacCMS V10 原生字段,中间是本站实际返回值,差异写在最后一列。
| 字段 | MacCMS V10 原生 | 本站输出 | 用途说明 |
|---|---|---|---|
| vod_id | 数字 ID,各站自定 | 数字 ID,站内唯一,跨源不冲突 | 做主键、做去重 |
| vod_name | 片名,可能含全角符号 | 片名,去掉首尾空格与全角标点 | 列表、搜索、排重 |
| vod_sub | 副标题,多数为空 | 副标题,无值时回空字符串 | 别名检索 |
| type_id | 分类 ID,各站定义不同 | 分类 ID,另附 type_path 三级路径 | 分类绑定 |
| type_name | 分类名 | 分类名,与 type_path 同步更新 | 导航与栏目页生成 |
| vod_pic | 封面,比例不统一 | 16:9 封面,另附 original_pic 竖版 | 卡片与详情页 |
| vod_year | 年份,可能带“年”字 | 四位年份整数 | 年份筛选 |
| vod_area | 地区,可能为空 | 地区,空值补“其他” | 地区筛选 |
| vod_lang | 语言 | 语言,多值用竖线分隔 | 字幕与配音筛选 |
| vod_remarks | 备注,写法自由 | 备注,统一为更新至X集/完结/修复 | 状态标识 |
| vod_play_from | 播放组标识 | 播放组,保持 $$$ 分组 | 播放器识别 |
| vod_play_url | 播放串 | 播放串,# 分集,$$$ 分组 | 播放地址 |
字段名保持不变,改动只在取值规范上。已经在跑的采集器不用改字段映射,换接口地址即可。
这周调用量靠前的 6 个接口
按控制台近 7 天的 detail 调用次数排,不含测试密钥。
对接排障速查表
六个最常被问到的问题,按现象查,不用翻文档。
| 现象 | 常见原因 | 处理动作 |
|---|---|---|
| 采集返回空列表 | 接口地址少了 ac=detail,或 pg 超出总页数 | 补 ac=detail,按返回的 pagecount 控制翻页 |
| 只收到前 20 条 | 单页固定 20 条,未翻页 | 用 pg 递增,最多取到 pagecount |
| 播到一半 404 | 源站切片地址过期或被防盗链拦截 | 换线路,或走 M3U8 解析接口代取 |
| 封面裂图 | vod_pic 仍是竖版地址 | 改用 16:9 封面字段,卡片按 16:9 容器裁 |
| 分类全部堆在一起 | 多个分类绑到了同一个 type_id | 按 type_path 逐条重绑,先空跑一页核对 |
| 入库时间倒挂 | 源站时区与本地差 8 小时 | 统一按 UTC+8 存 vod_time,展示层再格式化 |
配额怎么算:三种计法,按你的调用形态选
不按片库条数收费,也不按站点数收费。片库再大,只算你实际拉了几次。
行业动态
机房门禁、光缆割接、片源修复这类现场记录,一周一到两篇。
对接前先弄清这 5 件事
接口地址是什么格式,能直接用浏览器打开吗
列表地址是 http://接口域名/api/provide/vod/?ac=list,详情加 ac=detail。浏览器能直接打开,返回的是一段 JSON,第一层是 code 与 list 两个键。
采集频率有限制吗,会不会被封 IP
标准套餐按调用次数计,不额外限制频率,但同一 IP 连续请求超过 200 次每秒会排队。需要突发并发就开专属入口,配额按峰值 QPS 算。
返回的播放地址能不能直接播
能,绝大多数是标准 m3u8,个别源站有防盗链,走解析接口代取一次即可。我们不转存切片,只给地址。
有没有试用,试用能看到全部字段吗
有,测试密钥含 500 次调用,字段与正式一致,唯一差别是部分新片会延迟 2 小时入库。
接口地址变更会提前通知吗
会,变更前 7 天在控制台公告,旧地址保留 30 天可用,公告同时发到工单邮箱。