海洋CMS采集源失效了如何更换采集接口

采集源失效后，正确做法不是去改已入库的影片数据，而是在海洋CMS后台的资源库（采集接口）管理里新增一个可用接口，停用或删除失效接口，重新绑定分类映射，再执行一次采集；旧数据保留，用「采集当天」或指定ID补采即可。

怎么判断是采集源失效，而不是站点本身出问题？

结论：先用命令行直接访问接口地址，看返回状态码和内容，能一步区分是源挂了还是本地网络/权限问题。

在服务器或本地终端执行：

curl -I "http://接口域名/api.php/provide/vod/?ac=list"

返回 200 且响应头 Content-Type 是 text/xml 或 application/json，说明源正常；返回 404、403、502、503 或直接超时（curl: (7) Failed to connect），说明采集源已失效。常见失效原因有三种：资源站关停或换域名、接口路径改版（苹果CMS系接口常见路径是 /api.php/provide/vod/）、对方加了 UA 或 Referer 校验导致海洋CMS默认请求被拒。

如果 curl 能通但海洋CMS里采集报错，问题多半在本地：PHP 的 allow_url_fopen 被关闭、curl 扩展未装、或者采集超时时间设得太短。

更换采集接口的具体步骤是什么？

结论：核心动作是「新增接口 → 测试 → 绑定分类 → 停用旧接口」，顺序不要反，先删旧接口会导致分类映射丢失。

1. 登录海洋CMS后台，进入「采集」→「资源库管理」（部分版本叫「采集接口」或「自定义采集」），找到失效的那条接口，记下它绑定的分类和采集状态。
2. 点「添加资源库」，填写三项：资源库名称（自定义，如「XX资源站」）、接口地址、接口类型（XML 或 JSON）。地址填资源站给出的完整列表接口，例如 http://新域名/api.php/provide/vod/?ac=list。
3. 保存后点「测试」或「读取分类」，能读出分类列表就说明接口可用。
4. 进入分类绑定页面，把海洋CMS的本地分类（电影、电视剧、动漫等）对应到新接口的分类ID上。
5. 确认新接口采集正常后，再停用或删除旧接口。建议先「停用」观察 1-2 天，避免新源数据不全时无法回退。

采集接口地址该怎么写才不出错？

结论：苹果CMS系接口分列表地址和详情地址两种，海洋CMS只需要填列表地址，但 XML 和 JSON 两种格式的路径不同。

XML 格式：http://域名/api.php/provide/vod/at/xml/?ac=list
JSON 格式：http://域名/api.php/provide/vod/at/json/?ac=list

如果资源站只提供 ?ac=videolist 这种详情接口，海洋CMS一般也能直接采集，但要在资源库类型里选对 XML/JSON。地址中若带 & 参数，粘贴时不要手动转义成 &，后台会自动处理。另外注意：接口地址必须以 http:// 或 https:// 开头，只填域名加路径会提示格式错误。

换源之后，老数据要重新采吗？

结论：不需要删库重采。海洋CMS按影片ID或片名去重，换源后只采新增内容即可。

操作方式有两种：一是用「采集当天」只拉最近更新的影片；二是用「采集指定ID」补采某个资源站ID段。已入库的影片如果播放地址失效，可以在采集设置里勾选「更新已存在影片」，让新源覆盖旧的播放地址。注意：覆盖前先备份数据库，mysqldump -u 用户名 -p 数据库名 > backup.sql，避免源站数据质量差把原有信息冲掉。

换接口时最容易踩的坑有哪些？

结论：三个高频坑是分类ID对不上、接口需要请求头、采集频率被限。

• 分类ID对不上：新资源站的分类编号和旧源不同，必须重新绑定，否则采集回来的影片会全进「未分类」。
• 需要请求头：部分资源站校验 UA 或 Referer，海洋CMS若采集失败，可在服务器上用 curl -A "Mozilla/5.0" 接口地址 验证；确认是请求头问题，需要在采集设置或服务器层面补上。
• 频率被限：同一IP短时间大量请求会被封，把采集间隔调到 1-2 秒，单次采集数量控制在 200-500 条。

换源本质是把「接口地址 + 分类映射 + 去重策略」这三件事重新配一遍，配好后先小批量测试，确认数据完整再全量跑。