采集回来的内容能不能顺畅播放，第一决定因素是资源形态。鲨鱼资源（别名：鲨鱼资源站、鲨鱼采集接口）以m3u8切片资源为主，播放端兼容性表现较好，在对手机端与小屏体验比较敏感的影视站里出镜率很高。本词条围绕其接口地址格式、参数说明、配置要点与播放类故障的排查思路做档案式记录，同时收录别名变体与适配程序信息，供选型阶段参考。
基本信息
| 词条名 | 鲨鱼资源 |
|---|---|
| 别名变体 | 鲨鱼资源站、鲨鱼采集接口 |
| 接口类型 | 苹果CMS V10标准采集接口 |
| 数据格式 | JSON为默认输出，支持切换XML |
| 常见资源形态 | m3u8切片直链，切片粒度均匀 |
| 适用CMS | 苹果CMS V10（maccms10）及兼容V10接口规范的程序 |
| 更新频率评价 | 保持日常上新，热门内容的跟更速度处于中上水平 |
| 资源清晰度评价 | 以可流畅播放的常规画质为主，播放稳定性优于极限清晰度 |
接口地址格式
鲨鱼资源的接口地址依旧遵循V10规范，基础路径写作 api.php/provide/vod/，以下示例仅表达格式结构，接入时请以资源方提供的实际地址为准。由于该源主打切片播放，接入后最值得先验证的不是数据量，而是播放链路：拿到一条入库数据的播放地址后，先确认切片文件能被前台播放器正常加载，再决定是否批量采集。常用请求格式如下。
http://你的域名/api.php/provide/vod/?ac=listhttp://你的域名/api.php/provide/vod/?ac=detail&ids=1http://你的域名/api.php/provide/vod/?at=xml参数表
| 参数名 | 含义 | 示例值 |
|---|---|---|
| ac | 动作参数，list取列表，detail取指定编号的详情 | ac=detail |
| at | 格式开关，置为xml时返回XML数据，缺省为JSON | at=xml |
| ids | 影片编号，多值用英文逗号连接，配合详情动作查询 | ids=7,15 |
| pg | 分页序号，控制本次取第几页列表 | pg=2 |
| h | 小时范围过滤，圈出最近一段时间的新增与变更 | h=12 |
| t | 分类编号，仅输出该分类下的数据 | t=6 |
| wd | 片名关键词，用于接口内检索定位 | wd=示例 |
配置要点
- 先绑播放器再谈采集：后台启用m3u8播放器并与本接口的来源标识绑定，这是切片资源能正常前台播放的前提，顺序颠倒了会积累一批"入库即黑屏"的条目。
- 试采重点验播放：小规模试采后不要只看字段，要逐条点开播放页验证切片加载、拖动进度与自动连播是否正常，异常时按苹果CMS播放器问题排查手册逐项排查。
- 分类映射同步做：接口分类与站内栏目的对应关系在正式采集前完成映射，让切片资源按预期落位。
- 限流与缓存设置：切片资源播放时请求数比整片更高，前台侧建议开启缓存策略，采集侧控制好并发与间隔，避免双向挤占服务器资源。
- 接入防护不可省：对外采集的接口与自身站点都要做基本的安全防护，定期检查入库数据里是否混入异常跳转地址，相关方法见采集接口安全防护。
常见问题
前台播放黑屏，应该先排查哪里？
按链路顺序查：第一步取该条的播放地址在浏览器直接打开，确认切片文件本身可访问；第二步检查播放器类型是否为m3u8且已绑定来源；第三步看模板的播放页调用是否正确。三步中任何一步断了，对应处理即可，多数黑屏最终落在播放器绑定这一环。
接口列表里有的片子，站内搜索却找不到？
先确认该条是否真的入库成功，而不是采集中途被跳过；再检查分类映射是否把它归到了未展示的栏目；最后核对站内搜索的索引范围。三项都正常仍搜不到时，重建一次搜索索引通常可以解决。
晚间采集总是超时，和访问高峰有关吗？
有关系。晚间既是访客高峰也是各家资源站的负载高峰，接口响应普遍变慢。把批量采集挪到凌晨执行、单次条数适当调小，超时率会明显下降；若白天也频繁超时，则要排查自身服务器的出口网络。