索尼资源(别名:索尼资源网、索尼资源站)属于影视CMS通用格式的采集接口,突出特点是跨程序适配性好,苹果CMS、海洋CMS、飞飞CMS等主流程序都能按各自采集模块的填写方式直接对接。本词条以档案视角整理其接口地址格式、参数含义、配置要点与常见问题,并记录别名变体与适用程序范围,供建站者在多程序环境下比对选型时查阅。
基本信息
| 词条名 | 索尼资源 |
|---|---|
| 别名变体 | 索尼资源网、索尼资源站 |
| 接口类型 | 影视CMS通用格式采集接口 |
| 数据格式 | JSON与XML双格式输出 |
| 常见资源形态 | m3u8切片与mp4直链混合 |
| 适用CMS | 苹果CMS V10、海洋CMS、飞飞CMS等支持通用接口规范的程序 |
| 更新频率评价 | 整体节奏平稳,适合承担日常增量任务 |
| 资源清晰度评价 | 以常规画质为主体,部分条目带高清标注,入库前宜抽样核验 |
接口地址格式
索尼资源的基础路径形态为 http://你的域名/api.php/provide/vod/,实际使用时以资源方公布的地址为准。由于它面向多程序环境,同一个接口在不同CMS中的填法略有差别:苹果CMS V10可直接把基础路径填入自定义接口字段;海洋CMS与飞飞CMS则在其采集模块中选择对应的接口类型后再填入。请求时通过附加参数区分列表与详情:ac=list 取列表,ac=detail 配合 ids 取详情,at=xml 可把输出从默认的JSON切换为XML。接入前若想理清从请求到入库的完整链路,可先阅读资源采集原理科普:从接口到入库再到播放的完整链路。以下为三种常用请求格式示例。
http://你的域名/api.php/provide/vod/?ac=list
http://你的域名/api.php/provide/vod/?ac=detail&ids=1
http://你的域名/api.php/provide/vod/?at=xml&pg=1
参数表
| 参数名 | 含义 | 示例值 |
|---|---|---|
| ac | 请求动作,list取列表、detail取详情 | ac=list |
| at | 输出格式切换,取值xml时返回XML结构,缺省为JSON | at=xml |
| ids | 影片编号,可一次传多个,英文逗号分隔 | ids=12,35 |
| pg | 页码,配合ac=list翻页拉取 | pg=3 |
| h | 按小时限定更新时间窗口,用于增量采集 | h=12 |
| t | 分类编号,限定只返回该分类的数据 | t=2 |
| wd | 片名关键词检索 | wd=测试 |
配置要点
- 先核对程序版本:不同CMS对通用接口的解析细节存在差异,接入前确认所用程序版本支持标准V10接口参数,再决定是否需要微调字段映射。
- 输出格式全站统一:JSON与XML二选一并全站保持一致,避免两套解析逻辑并存造成字段风格混乱。
- 增量窗口不宜过宽:配合h参数把每轮增量限定在合理的小时数内,请求量可控,日志也更易核对。
- 播放器随资源形态配置:m3u8与mp4直链并存时,后台应同时备好对应播放器并正确绑定到采集来源。
- 迁移场景留存配置:跨程序搬迁站点时,把接口地址、分类映射与播放器绑定一并导出备份,可大幅缩短重新调试的时间。
常见问题
同一接口能否同时供给多个CMS程序使用?
可以。通用格式接口的意义就在于一份地址可供多端取数,但各程序的分类编号体系互不相同,建议每个程序单独维护一套分类映射,采集任务也分开配置,避免互相覆盖。
换程序后采集下来的字段对不上怎么办?
多半是字段映射没有随程序调整。先比对接口原始返回与新程序的入库字段表,确认片名、分类、播放地址等关键字段的对应关系,再在采集设置里修正映射;若个别字段始终为空,可先放宽范围采集,再人工补齐。
接口访问正常但拉到的数据条目很少是何原因?
优先检查参数组合:t限定的分类在该时段可能没有更新,h窗口过窄也会导致返回偏少。把时间窗口放宽一档,或去掉分类限定做一次对照请求,即可判断是参数问题还是来源更新节奏问题。