广告位

广告合作 · 联系tg:@wugang5

首页 › 资源接口 › 西瓜资源

西瓜资源

立即前往 →即将离开本站,前往外部站点

给影视站挑选采集来源时,常有站长问起西瓜资源(别名:西瓜资源网、西瓜采集接口)好不好用。把它放进行业里横向比较,最突出的特点是资源形态“两条腿走路”:既输出m3u8切片,也提供直链云播,接入适配苹果CMS、海洋CMS、飞飞CMS、赞片CMS等常见程序,资源分类集中在电影、电视剧、动漫、综艺四个主方向。本词条以档案视角整理这份接口的地址写法、参数清单、配置步骤与高频疑问,供建站选型与日常维护时对照取用。

基本信息

词条名西瓜资源
别名变体西瓜资源网、西瓜采集接口
接口类型苹果CMS V10标准采集接口
数据格式JSON为主,按V10规范可切换XML输出
常见资源形态m3u8切片与直链云播并存
适用CMS苹果CMS V10、海洋CMS、飞飞CMS、赞片CMS等
更新频率评价日常保持增量更新,剧集类内容随播出进度跟进,具体节奏以实测采集结果为准
资源清晰度评价画质分层较为明显,同一分类内高清与普清条目混合,建议抽检后按栏目分流使用

接口地址格式

西瓜资源的接口遵循V10规范的通用约定,基础路径固定为provide/vod结构,差异主要体现在查询参数的组合上。列表请求、格式切换与增量过滤分别对应不同的参数搭配,站长可以先在浏览器地址栏手工拼一次请求,确认返回报文结构无误后,再把同样的地址填入后台采集设置。以下示例中的域名均为占位写法,替换成资源方公告的接入域名即可。

http://你的域名/api.php/provide/vod/?ac=list
http://你的域名/api.php/provide/vod/?at=xml
http://你的域名/api.php/provide/vod/?ac=list&h=24

参数表

参数名含义示例值
ac请求动作,list对应列表拉取,detail对应单条详情ac=list
at输出格式,填xml时返回XML文档,不填则按JSON返回at=xml
ids指定影片编号,多个编号用英文逗号串联,常与detail动作联用ids=5,8
pg列表页码,从1开始递增,用于分批遍历全库pg=1
h时间窗过滤,单位为小时,只取最近该时段的新增与变更h=24
t分类过滤,取资源站的分类编号,缩小单次拉取范围t=2
wd关键字检索,按标题匹配接口内的影片wd=示例词

配置要点

  1. 第一步确认接入形态:先明确站内播放器方案,再决定以切片还是直链为主,两种形态可分别绑定不同播放器,省去后续批量改库的麻烦。
  2. 接着完成分类映射:接口侧四类内容与站内栏目一一对应;综艺条目多为整季结构,按季拆分还是整体合并要提前定好规则,避免中途反复调整。
  3. 采集节奏把控:全量首采按页码分段执行,每段之间留出间隔;日常增量用h参数限定时间窗,并把定时任务安排在业务低峰时段。采集在整个链路中的位置与原理,可参考资源采集原理科普:从接口到入库再到播放的完整链路一文。
  4. 去重策略:切片与直链两条线可能对应同一影片的不同版本,入库前以编号加标题联合判断,防止重复条目挤占库容。
  5. 上线前播放核验:对综艺与剧集各抽几集,确认切片可拖动、直链可加载,再放行到前台展示。

常见问题

m3u8和直链云播两条线,站内应该如何取舍?

两种形态各有侧重:切片对拖动与分段加载更友好,直链则少了切片封装这一层,加载路径更直接。以长视频为主的站点可优先m3u8并绑定对应播放器,直链作为补充来源绑定另一组播放器。拿不准时,先小批量各采若干条目对比播放表现,再确定主推形态。

采集执行到一半中断,续采必须从头开始吗?

不需要。按页码分段采集时,记录中断前已完成的页码,从下一页继续即可;增量场景下用h参数缩小时间窗,也能快速补齐中断期间遗漏的更新。养成翻看采集日志的习惯,这类问题的定位通常只需几分钟。

相关词条

当前实链

以下接口地址经本站实测校验(2026-10-03),可直接复制到 CMS 后台资源库配置中使用。

接口地址(XML 数据格式):

https://caiji.xgzyapi.com/api.php/provide/vod/at/xml

接口地址(JSON 数据格式):

https://caiji.xgzyapi.com/api.php/provide/vod/?ac=list

实测状态:接口正常返回且数据结构完整。采集类站点接口域名可能随时间调整,若地址失效请以资源站公告为准。

延伸阅读:wugang5 影视资源坊:采集官网收录与更新观察