在以数字代号命名的采集接口里,155资源(别名:155资源站、155采集接口)是被提起次数较多的一支,在建站圈流传的时间也不短。本词条按档案体例整理它的地址格式、参数含义、接入步骤与排错思路,别名写法一并留档,供新老站点在核对接口信息时参照。
基本信息
| 词条名 | 155资源 |
|---|---|
| 别名变体 | 155资源站、155采集接口 |
| 接口类型 | 苹果CMS V10标准采集接口 |
| 数据格式 | JSON与XML两种格式均可输出 |
| 常见资源形态 | 以m3u8切片直链为主 |
| 适用CMS | 苹果CMS V10(maccms10)及兼容V10接口规范的程序 |
| 更新频率评价 | 增量更新保持规律,历史库存完整度较高 |
| 资源清晰度评价 | 常规画质为主,新上条目可见高清版本,建议抽验后入库 |
接口地址格式
数字代号的接口在网上流传的地址写法版本不少,核对路径时应以资源方当前提供的地址为准,本文只描述通用格式:基础路径为 http://你的域名/api.php/provide/vod/,动作与输出格式均通过路径后附加的参数区分。列表与详情共用路径;需要按更新时间做增量时,追加h参数限定小时窗口即可。以下三种写法覆盖了日常接入的大部分场景。
http://你的域名/api.php/provide/vod/?ac=list
http://你的域名/api.php/provide/vod/?ac=list&h=24
http://你的域名/api.php/provide/vod/?ac=detail&ids=1,2
参数表
| 参数名 | 含义 | 示例值 |
|---|---|---|
| ac | 动作标识,list对应列表数据、detail对应详情数据 | ac=list |
| at | 格式切换参数,取xml时返回XML文档,缺省输出JSON | at=xml |
| ids | 影片编号,多值用英文逗号串联,供detail模式定位条目 | ids=1,2 |
| pg | 分页序号,指定拉取列表数据的第几页 | pg=3 |
| h | 时间窗参数,按小时圈定最近更新的数据范围 | h=24 |
| t | 分类编号,仅返回该分类下的条目 | t=6 |
| wd | 关键词参数,按片名模糊检索接口库存 | wd=示例 |
配置要点
- 地址逐字符核对:数字代号接口的流传写法多,绑定前把路径与参数拼写和资源方提供稿逐字符比对,错一个字符整轮任务都会空跑。
- 双格式各拉一页:JSON与XML各请求一次,确认程序解析端适配哪一种再固定下来,两种格式混用会抬高排错成本。
- 全量分批推进:老库存体量不小,按分类或页码把全量任务拆成多轮,每轮结束观察一次服务器负载再继续。
- 增量定时配窄窗口:日常增量用h参数收窄范围,任务间隔按站点内容需求设定,不必盲目求快。
- 播放器一次配好:m3u8为主的资源对应m3u8播放器,绑定后无需频繁调整,两种格式的差异可参考m3u8、切片、直链三种资源形态的区别与适用场景。
常见问题
新站第一次接入,先跑全量还是先跑增量?
建议的顺序是:先小范围采几页确认数据质量,再做全量铺底,最后切到增量定时任务。直接开增量会让新站前台显得空荡;不做验证就全量,一旦格式不匹配,会堆积大量待清理条目。
采集回来的条目简介字段空着,能补吗?
部分老条目在源站本身就没有完整简介。程序端通常支持对已入库条目做覆盖采集,可以隔一段时间对空简介条目重跑一次;若覆盖后仍为空,说明源站缺该字段,人工补写或保持留空即可。
定时任务偶尔超时,要不要调整节奏?
超时多发生在源站响应慢或网络抖动的时段。可以把任务间隔拉长、单轮页数调小,并给任务设置失败后的重试上限;接口信息来路不明时应先核对安全风险,防范思路见采集接口安全防护:防挂马、防劫持、防信息泄露。