给影视站挑选采集来源时,常有站长问起西瓜资源(别名:西瓜资源网、西瓜采集接口)好不好用。把它放进行业里横向比较,最突出的特点是资源形态“两条腿走路”:既输出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=示例词 |
配置要点
- 第一步确认接入形态:先明确站内播放器方案,再决定以切片还是直链为主,两种形态可分别绑定不同播放器,省去后续批量改库的麻烦。
- 接着完成分类映射:接口侧四类内容与站内栏目一一对应;综艺条目多为整季结构,按季拆分还是整体合并要提前定好规则,避免中途反复调整。
- 采集节奏把控:全量首采按页码分段执行,每段之间留出间隔;日常增量用h参数限定时间窗,并把定时任务安排在业务低峰时段。采集在整个链路中的位置与原理,可参考资源采集原理科普:从接口到入库再到播放的完整链路一文。
- 去重策略:切片与直链两条线可能对应同一影片的不同版本,入库前以编号加标题联合判断,防止重复条目挤占库容。
- 上线前播放核验:对综艺与剧集各抽几集,确认切片可拖动、直链可加载,再放行到前台展示。
常见问题
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
实测状态:接口正常返回且数据结构完整。采集类站点接口域名可能随时间调整,若地址失效请以资源站公告为准。