海洋 CMS 采集接口如何添加到后台

海洋CMS 添加采集接口的入口在后台左侧「采集」菜单下的「采集接口」（部分版本显示为「资源库」），点「添加」，只需填接口名称、接口地址、数据格式（XML 或 JSON）三项，保存并测试能拉到数据后，再去绑定分类，就能正常采集入库。

海洋CMS 的采集接口在哪里添加？

结论：路径是「后台登录 → 左侧菜单采集 → 采集接口/资源库管理 → 添加」。

登录后台后看左侧导航，找「采集」这一栏，展开后一般有「采集接口」「采集节点/分类绑定」「采集数据」几个子项，接口管理通常排在第一个。如果左侧根本没看到「采集」菜单，通常是两个原因：一是当前登录账号不是超级管理员，用管理员账号重新登录；二是该系统版本把采集模块做成了可关闭的功能，需要在系统设置里先开启。

添加采集接口要填哪些字段？

结论：核心只有 4 个字段——接口名称、接口地址、数据格式、是否启用，其余留默认即可。

• 接口名称：随便起，但建议写清资源站名字，比如「XX资源站」，后面绑定分类和采集数据时靠它区分。
• 接口地址：资源站提供的采集 API 网址，直接复制，不要手动改参数。
• 数据格式：下拉选 XML 或 JSON，必须和地址实际返回的格式一致。
• 是否启用：选「是」，否则后面绑定分类时列表里看不到它。

保存之后，界面上一般会有「测试」或「刷新」按钮，点一下能看到返回的影片条数或分类列表，就说明接口通了。

XML 接口和 JSON 接口有什么区别？地址该怎么写？

结论：两者只是数据返回格式不同，海洋CMS 两种都支持；地址一般形如 https://资源站域名/api.php/provide/vod/，要 JSON 就写 .../api.php/provide/vod/at/json/，要 XML 就写 .../api.php/provide/vod/at/xml/。

海洋CMS 兼容苹果CMS v10 的通用采集接口格式，所以市面上大部分资源站的接口都能直接用。实操中有两点要注意：

1. 数据格式必须和地址对应。填了 XML 却去请求 JSON 地址，后台会报「数据解析失败」或一直显示 0 条数据。
2. 如果资源站只给了 .../api.php/provide/vod/ 这种裸地址且拉不到数据，在末尾追加 ?ac=videolist 再试一次。

另外，接口地址结尾的斜杠尽量保留，前后不要带空格——复制粘贴时最容易被带上。

接口添加成功后，怎么绑定分类并开始采集？

结论：顺序是「先建本地分类 → 再绑定资源站分类 → 最后采集数据」，跳过第一步会导致采集回来的影片没有分类。

具体步骤：

1. 进「分类管理」，把你想要的分类（动作片、喜剧片、连续剧等）先建好。
2. 进「采集」下的分类绑定页面，选中刚添加的接口，点「读取分类」，界面会列出资源站的分类。
3. 点「一键绑定/自动绑定」，系统按分类名称匹配；名称对不上的（比如资源站叫「动作片」、你本站叫「动作电影」）手动用下拉框逐个绑定。必须全部绑完，漏掉的分类采集时会被直接丢弃。
4. 进「采集数据」，选接口、选采集范围（当天、本周、全部、指定 ID、指定页），设置每页采集条数和采集间隔，点开始采集。
5. 采完去「视频管理」核对，确认标题、播放地址、分类都正常。

需要长期自动更新，就在采集设置里开启自动采集，再在服务器上配一条 crontab 定时访问采集触发地址。

添加采集接口时最容易踩的 4 个坑

结论：接口加不上、加上了采不到数据，90% 出在下面四点。

第一，数据格式和接口地址不匹配，报解析失败。第二，接口地址带空格或漏斜杠，请求直接 404。第三，分类没绑全，采了几千条却发现一半影片没进库。第四，PHP 执行超时——采集几百条后页面卡死或中断，需要把 max_execution_time 调到 300 秒以上，memory_limit 调到 256M 以上，并把「每页采集数量」调小、分批采。如果接口测试一直失败且服务器关了 allow_url_fopen，确认 PHP 的 cURL 扩展已安装并启用。

总之，海洋CMS 加采集接口就是「添加接口 → 测试连通 → 绑定分类 → 采集数据」四步，字段只有名称、地址、格式三个关键项，真正决定成败的是地址格式对不对、分类绑没绑全、PHP 超时限制够不够。