靠定时任务做增量采集的站点,接口响应速度直接决定每轮任务的耗时与成功率。闪电资源(别名:闪电资源站、闪电采集接口)以响应快为主要特征,短间隔增量场景下的适配度较高。本词条从地址格式、参数含义、高频采集的配置要点与典型疑问四个方面留档,供制定增量策略时参考。
基本信息
| 词条名 | 闪电资源 |
|---|---|
| 别名变体 | 闪电资源站、闪电采集接口 |
| 接口类型 | 苹果CMS V10标准采集接口 |
| 数据格式 | JSON为主,支持切换XML |
| 常见资源形态 | m3u8切片直链为主 |
| 适用CMS | 苹果CMS V10(maccms10)及遵循V10接口规范的程序 |
| 更新频率评价 | 更新较勤,短时间窗增量的收益明显 |
| 资源清晰度评价 | 新上条目画质较好,历史条目新旧混杂 |
接口地址格式
高频增量的关键在h参数:把时间窗压窄,每次只取最近更新的条目,返回体积小、响应自然快。基础路径为 http://你的域名/api.php/provide/vod/,动作与格式仍由参数控制,下面依次是窄窗口列表、普通列表与详情请求的格式示例,正式接入时替换为资源方提供的地址。
http://你的域名/api.php/provide/vod/?ac=list&h=24
http://你的域名/api.php/provide/vod/?ac=list
http://你的域名/api.php/provide/vod/?ac=detail&ids=1
参数表
| 参数名 | 含义 | 示例值 |
|---|---|---|
| ac | 动作参数,list取列表、detail取详情 | ac=list |
| at | 输出格式,取xml切换XML,默认JSON | at=xml |
| ids | 影片编号,detail模式定位条目,逗号分隔多值 | ids=1 |
| pg | 页码,列表请求的翻页序号 | pg=2 |
| h | 小时窗口,高频增量场景使用最频繁的参数 | h=24 |
| t | 分类编号,限定返回的栏目范围 | t=6 |
| wd | 片名关键词检索 | wd=测试 |
配置要点
- 窗口收窄:h参数取小值,让每轮任务只处理最新增量,单轮耗时随之下降,日志也更好读。
- 间隔留余量:任务间隔不要压到极限值,给接口留出响应余量,长期稳定比短期密度更重要。
- 串行请求:单轮任务内按页串行拉取,避免并发冲高触发源站限制。
- 重试设上限:连续失败达到阈值就暂停任务并提醒自己介入,防止定时任务空转消耗。
- 每轮落日志:把当轮入库条数写进日志,波动异常时优先排查接口侧,再回头查程序配置。
常见问题
采集间隔设到几分钟比较合适?
没有统一答案,取决于站点内容需求与接口承受度。一般从半小时起步观察几轮,确认每轮都有稳定增量后再逐步收紧;一旦出现超时或空返回增多,说明间隔已经贴到接口余量边缘,应回调。
请求频率太高会有什么后果?
轻则响应变慢、单轮耗时拉长,重则被源站临时限流,任务集中报错。此时应拉长间隔、缩小单轮页数,或者把负载分摊到多个源上,轮询分流的做法见多采集源轮询策略:防单源失效停更。
每轮采到的条数时多时少,正常吗?
基本正常,增量条数随源站更新节奏波动。值得留意的是长期趋势:把每轮采集量画成曲线更容易看出异常,看板化监控的搭建思路可参考苹果CMS站点监控:采集量与收录数据看板搭建。