ok资源(别名:ok资源网、ok资源站)是一套上线时间较长、门类覆盖较全的综合型影视采集接口,在不少建站者的源清单里属于常备项。本词条以档案视角对其接口地址格式、参数含义、配置要点与常见故障逐项留档,并把社区中流传的别名写法一并收录,方便选型比对与站内检索。
基本信息
| 词条名 | ok资源 |
|---|---|
| 别名变体 | ok资源网、ok资源站 |
| 接口类型 | 苹果CMS V10标准采集接口 |
| 数据格式 | 默认输出JSON,可切换XML |
| 常见资源形态 | m3u8切片直链为主 |
| 适用CMS | 苹果CMS V10(maccms10)及遵循同一接口规范的程序 |
| 更新频率评价 | 长期保持规律增量,节奏平稳 |
| 资源清晰度评价 | 各门类清晰度不一,入库前建议抽样核验 |
接口地址格式
ok资源沿用苹果CMS V10通行的接口路径写法,基础形态为 http://你的域名/api.php/provide/vod/,本文仅作格式示意,实际接入时请替换为资源方提供的地址。列表请求与详情请求共用同一路径,靠参数区分:列表默认返回JSON,追加at=xml可换成XML结构;详情请求由ac=detail配合ids编号完成,多个编号用英文逗号连接。这套路数与资源采集原理科普:从接口到入库再到播放的完整链路中描述的标准流程一致。以下为三种常用请求的格式示例。
http://你的域名/api.php/provide/vod/?ac=list
http://你的域名/api.php/provide/vod/?at=xml
http://你的域名/api.php/provide/vod/?ac=detail&ids=1
参数表
| 参数名 | 含义 | 示例值 |
|---|---|---|
| ac | 动作参数,list取列表、detail取详情,二者共用同一路径 | ac=list |
| at | 输出格式开关,填xml时整套数据转为XML结构,缺省为JSON | at=xml |
| ids | 影片编号串,英文逗号分隔多值,仅在detail模式下生效 | ids=1,2,3 |
| pg | 页码,控制列表数据翻到第几页 | pg=2 |
| h | 小时级时间窗,限定只返回最近若干小时内更新的条目 | h=24 |
| t | 分类编号,把列表收窄到指定栏目 | t=6 |
| wd | 片名关键词,按名称在接口内检索 | wd=测试 |
配置要点
- 小批量试采再放量:接口绑定完成后先手动采一页,核对标题、分类、播放地址三类字段是否齐全,确认数据结构没有异常后再执行大批量任务;若计划长期运行,可结合多采集源轮询策略:防单源失效停更里的多源思路做冗余。
- 分类映射前置:首次采集前先在绑定界面把接口分类逐项对到站内栏目,避免数据先堆进待整理区再返工。
- 增量窗口固定:日常增量建议配合h参数限定时间范围,每轮只处理最近更新的部分,日志里也容易核对当轮采集量。
- 重复条目控制:增量轮次之间用影片编号加标题双条件查重,防止同一资源反复入库形成冗余。
- 播放器绑定到位:资源以m3u8切片直链为主,后台需配置对应的m3u8播放器并挂到采集来源上,前台播放页才能正常出画面。
常见问题
列表能拉到数据、详情却返回空,是哪里出了问题?
多数情况是ids参数传递有误,比如编号写错、逗号用了全角,或请求被截断。先用单个编号在浏览器里直接请求一次,确认返回内容后再回到程序里排查传参环节;若单编号请求同样为空,可能是该条目在源站已下架。
同一部影片为什么采出了多条记录?
常见原因是多轮采集之间没有做查重,或不同分类下存在同名条目被分别入库。建议开启程序自带的查重开关,并以影片编号作为主判据;历史遗留的重复条目可以在后台按标题聚类后批量合并。
接口白天响应快、夜里明显变慢,需要处理吗?
采集请求同样受源站负载影响,夜间高峰期变慢属常见现象。把定时任务挪到访问低谷时段,或将单轮任务的分页数量调小,通常即可缓解;若长时间无响应,应暂停任务并检查接口是否仍在服务。