AppleCMS 采集接入

本页面向下游站长。参数由当前部署在启动时注入；更新配置并重新启动门户即可同步，无需改文档正文或重新构建镜像。

采集使用统一的 App JSON / AppleCMS XML 合同。先完成分类绑定与播放器来源，再用小批量核对标题、集数、海报和播放，再打开定时增量。

建议： 采集时尽量把海报下载到自己的存储。接口里的图片地址可直接调用，但本地留底能避免后续图源失效。若 XML 偶发解析失败，退出采集列表再重新进入即可。

采集地址

标准采集根地址：

https://api.juliang.live/api/provide/vod

按用途选用下面的地址。根地址以本页注入值为准；统一使用 /api/provide/vod/；根地址不要包含结尾斜线，以下完整地址按用途复制。新入口不兼容旧采集路径。

综合资源一次返回两个公开播放组。若站点只接智能线路或只接播放器页，请改用带 from 的单组地址，避免采集到未配置的播放来源。

公开播放组

智能线路单集地址由已发布合同提供，形态如下：

https://jimaoys98.com/public/playback/{token}/smart.m3u8

{token} 随内容与分集变化，不要手工拼接。巨量播放器组返回的是播放页地址，不是 M3U8；智能线路组已经是可播清单，播放器解析地址应留空。

上面是全局 M3U8 地址形态。实际采集结果会按发布渠道、分类和线路使用各自域名；请完整保存接口返回的 URL 与查询参数，不要统一替换域名。

分类映射

以下内容由当前渠道公开配置生成。首次采集必须先绑定分类，未绑定的分类不会入库。

待部署配置

苹果 CMS V10

本站 XML 接口可直接加入苹果 CMS V10 自定义资源库。

添加资源库

依次打开【采集】-【自定义资源库】-【添加】，按下面填写后保存。

综合资源：

资源名称：巨量资源综合
接口地址：https://api.juliang.live/api/provide/vod/at/xml/
接口类型：xml
资源类型：视频

只要智能线路：

资源名称：巨量智能线路
接口地址：https://api.juliang.live/api/provide/vod/from/jlm3u8/at/xml/
接口类型：xml
资源类型：视频

只要播放器页：

资源名称：巨量播放器
接口地址：https://api.juliang.live/api/provide/vod/from/jlplayer/at/xml/
接口类型：xml
资源类型：视频

绑定分类

第一次采集会提示绑定分类。请按本页「分类映射」把对方分类对应到自己站点的分类，保存后再执行采集。

添加播放器

采集完成后如果片源没有自动选中，通常是后台还没有对应播放来源。请先按「播放器来源」登记两个公开播放组，再点击右上角【清缓存】。

智能线路已经输出可播 M3U8。若该播放器还填了后台自带解析口，请清空解析地址，否则可能无法播放。

设置自动采集

绑定分类并完成一次小批量采集后，再在采集任务里打开定时。增量窗口建议使用 24 小时，对应接口参数 h=24。宝塔或其他计划任务只需定时访问苹果 CMS 自己的采集入口，不必直接打本站地址。

先在自定义接口列表测试采集，再复制测试链接。

进入【系统】-【定时任务配置】，新增并启用采集任务。

保存后先点击【测试】，确认后台能正常执行。

测试成功后复制任务链接，交给宝塔等外部计划任务调用。

宝塔计划任务建议每 30 分钟执行一次。图中的域名是脱敏示例，实际填写苹果 CMS 生成的任务链接。

苹果 CMS V8

苹果 CMS V8 通过快捷菜单接入。打开【首页】-【快捷菜单配置】，添加下面三行后保存。flag 只是站点本地标识，可按自己的命名修改。

巨量资源综合,?m=collect-list-ac2--hour--xt-1-ct--group--flag-jumbo-apiurl-https://api.juliang.live/api/provide/vod/at/xml/
巨量智能线路,?m=collect-list-ac2--hour--xt-1-ct--group--flag-jumbo-smart-apiurl-https://api.juliang.live/api/provide/vod/from/jlm3u8/at/xml/
巨量播放器,?m=collect-list-ac2--hour--xt-1-ct--group--flag-jumbo-player-apiurl-https://api.juliang.live/api/provide/vod/from/jlplayer/at/xml/

绑定分类

进入采集列表后先绑定分类。列表中的两个播放组标识必须与本页公开播放组一致。

设置自动采集

进入【系统】-【定时任务管理】，打开采集任务的修改页面。

保存采集参数前核对 24 小时增量窗口和执行时段。

保存后先测试任务，再复制测试链接。

把苹果 CMS 生成的链接填入宝塔计划任务，建议每 30 分钟执行一次。

点击采集提示 404

部分 V8 后台会把网址参数丢掉。请确认浏览器地址仍包含 admin/index.php?m= 这一段，不要只留下 admin_maccj.php。补回入口后再进入采集列表。

没有选中播放片源

同样需要先添加播放器来源，再清空缓存。播放器标识必须与接口返回的播放组代码完全一致。

海洋 CMS

海洋 CMS 使用兼容 XML 地址。打开【采集】-【资源库管理】，新增资源库：

资源库名称：巨量资源
综合资源：https://api.juliang.live/api/provide/vod/at/xml/
智能线路：https://api.juliang.live/api/provide/vod/from/jlm3u8/at/xml/
播放器页：https://api.juliang.live/api/provide/vod/from/jlplayer/at/xml/

部分海洋版本也可以把标准 XML 填进快捷采集：

巨量资源综合,admin_reslib.php?ac=list&rid=&url=https://api.juliang.live/api/provide/vod/at/xml/
巨量智能线路,admin_reslib.php?ac=list&rid=&url=https://api.juliang.live/api/provide/vod/from/jlm3u8/at/xml/

保存后从【首页】快捷菜单进入资源库列表。若提示暂无播放数据，先按「播放器来源」登记两个公开播放组，再更新缓存。

智能线路不需要额外部署解析包。把解析地址留空，让播放器直接打开接口返回的 M3U8。

飞飞与赞片 CMS

飞飞、赞片与其他兼容苹果 CMS XML 的系统，统一使用综合或单播放组 XML 地址。

综合资源：https://api.juliang.live/api/provide/vod/at/xml/
智能线路：https://api.juliang.live/api/provide/vod/from/jlm3u8/at/xml/
播放器页：https://api.juliang.live/api/provide/vod/from/jlplayer/at/xml/

飞飞 CMS

在资源库管理中把接口类型选为 XML，资源类型选视频。采集前先按「播放器来源」登记两个播放器标识，必须与本页公开播放组代码完全一致。

先登记巨量播放器，标识填写本页播放器组代码，独立解析地址留空。

再登记巨量智能线路，标识填写智能线路组代码，独立解析地址同样留空。

飞飞 5.0 若无法采集多组播放地址，确认系统能按 $$$ 拆分播放组、按 # 拆分集数。智能线路组内每一集已是独立 URL，可被逐集播放器消费。

赞片 CMS

赞片 CMS 添加播放器时，名称用「巨量智能线路」「巨量播放器」，标识分别填写本页两个公开播放组代码，解析地址留空。完成后清空缓存，再执行小批量采集。

进入【采集管理】-【资源采集】，点击新增资源。

接口类型选择 XML，资源 URL 填写本页综合或单播放组地址。

进入【内容管理】-【播放器管理】，点击添加。

播放器标识必须与接口返回代码一致，解析地址保持空白。

播放器来源

两个公开播放组都要在下游 CMS 登记，否则采集结果无法自动选中片源。

标识必须与采集结果里的播放组代码一致，包括大小写。不要填写第三方解析域名去二次包装本站地址。

添加完成后务必清缓存。先抽查一条电影和一条多集内容，分别打开两个播放组，确认可以出画，再放大采集范围。

JSON 接口

移动端、自研程序或只消费 JSON 的采集器使用下面两个入口。省略全部参数时，返回第 1 页、默认 20 条，并给出过滤条件下的全部总量。

列表：https://api.juliang.live/api/provide/vod/?ac=list
详情：https://api.juliang.live/api/provide/vod/?ac=detail
XML：https://api.juliang.live/api/provide/vod/at/xml/

调用示例：

https://api.juliang.live/api/provide/vod/?ac=list&pg=1&pagesize=20
https://api.juliang.live/api/provide/vod/?ac=detail&ids=101
https://api.juliang.live/api/provide/vod/at/xml/?ac=detail&h=24
https://api.juliang.live/api/provide/vod/?ac=list&t=1&wd=标题

JSON 使用 page / pagecount / limit / total / list。XML 使用 list 节点上的 page、pagecount、pagesize、recordcount。total 与 recordcount 是过滤后的全部条数，不是当前页长度。

自动采集

先完成分类绑定、播放器登记和小批量对账，再打开定时任务。

推荐节奏：

• 全量：绑定后执行一次，核对分类、海报、集数与双播放组
• 增量：每 15 到 60 分钟采集最近 24 小时，对应 h=24
• 失败：停止批量，保留失败样本，不要连续重放同一错误页

苹果 CMS 定时任务走其后台采集入口。本站增量过滤使用 h，合法范围是 1 到 168 小时。超出范围会返回明确错误，不会静默改成全量。

常见问题

采集后没有选中播放片源：后台缺少与播放组代码一致的播放器。补上来源并清缓存。

智能线路无法播放：该组已经是 M3U8，请清空播放器解析口，直接播放返回地址。不要再套一层解析。

只想接一条线路：使用带 from 的单组地址，不要采集综合资源后再手工删组。

分类是空的或不对：先看本页分类映射，完成绑定后再采集。未绑定分类不会进入内容库。

海报能采集但过几天失效：在 CMS 中打开图片本地下载。接口图片地址可调用，本地副本更稳妥。

XML 偶发出错：退出采集列表再进入，或换一页重试。不要把瞬时失败当成接口下线。

想更换域名或线路前缀：在发布渠道配置中修改并保存，按保存后的五个地址更新采集器。M3U8、分享页和图片可分别继承或覆盖，无需改写已发布清单。

未知的 from、超限的 ids 或非法的时间窗口会返回 4xx。请按本页参数表修正后再请求。

变更纪律

• 采集地址、播放组代码和分类映射均以部署配置为准。
• 线路前缀默认 jl，对应 jlm3u8 / jlplayer；具体值以目标渠道配置为准。
• 遇到异常时先停止批量采集，保留失败样本用于对账。
• 本站不把内部线路名、来源站名或后台标识输出到采集协议里。