接口使用说明
四步开始采集
接口无需登录,格式与苹果CMS v10 采集接口一致,默认返回 JSON,也可以取 XML。下面按苹果CMS 后台的操作顺序来写。
添加采集地址
https://zy.heitaodj.com/api.php/provide/vod/https://zy.heitaodj.com/api.php/provide/vod/?at=xml在苹果CMS 后台「采集 → 自定义接口」里点「添加」,照下面填:
- 资源名称
- 自己起一个名字,方便区分。必填。
- 接口地址
- 上面的 JSON 采集地址。
- 接口类型
- JSON。如果填的是 XML 地址,这里选 XML。
- 资源类型
- 视频。
- 数据操作
- 新增+更新。
绑定分类
在自定义接口列表里点开本站,会列出下表这些分类。逐个点「绑定」,对应到你自己站点的分类。没绑定的分类,采集时会整条跳过。
影片都挂在二级分类下,也就是上级 ID 不为 0 的那些。按分类取数据时,t 要填二级分类 ID。
| 分类 ID | 分类名称 | 上级 ID |
|---|---|---|
| 1 | 现代都市 | 0 |
| 2 | 古装传奇 | 0 |
| 3 | 仙侠玄幻 | 0 |
| 4 | 科幻脑洞 | 0 |
| 5 | 灵异悬疑 | 0 |
| 6 | 其他短剧 | 0 |
| 11 | 情感爱恋 | 1 |
| 12 | 职场权色 | 1 |
| 13 | 家庭纠葛 | 1 |
| 14 | 逆袭打脸 | 1 |
| 15 | 群芳后宫 | 1 |
| 16 | 年代风月 | 1 |
| 17 | 都市其他 | 1 |
| 64 | 校园爱情 | 1 |
| 21 | 宫廷权谋 | 2 |
| 22 | 武侠江湖 | 2 |
| 23 | 古装言情 | 2 |
| 24 | 后宫争宠 | 2 |
| 25 | 古装其他 | 2 |
| 31 | 宗门情仇 | 3 |
| 32 | 双修升级 | 3 |
| 33 | 系统逆袭 | 3 |
| 34 | 仙侠其他 | 3 |
| 41 | 未来科幻 | 4 |
| 42 | 游戏副本 | 4 |
| 43 | 异能超能 | 4 |
| 44 | 身体奇谭 | 4 |
| 45 | 末世求生 | 4 |
| 46 | 科幻其他 | 4 |
| 51 | 都市怪谈 | 5 |
| 52 | 鬼艳志怪 | 5 |
| 53 | 悬疑反转 | 5 |
| 54 | 灵异其他 | 5 |
| 61 | 综合脑洞 | 6 |
| 62 | 未分类型 | 6 |
添加播放器
本站只有一个播放组,标识是 zym3u8,片源是 m3u8 直链,不需要解析。没有这个播放器的话,采集时会直接把播放地址丢掉,所以一定要在开始采集之前导入。
mac_zym3u8.txt(苹果CMS 播放器导入文件)
下载播放器文件
- 后台「视频 → 播放器」,点「导入」,选刚下载的文件,保存。
- 点后台右上角的「清理缓存」。
这个文件用的是苹果CMS 自带的 DPlayer,不依赖本站服务器。想手动添加也可以:编码填 zym3u8,解析状态选禁用,其余照自带的 DPlayer 播放器填。已经有 zym3u8 播放器的站点不用重复导入,导入会覆盖同名配置。
开始采集
第一次用「采全部」拉全量;之后每天用「采当天」补新片就够了,也可以在后台「定时挂机」里设成自动采集。
常用地址
https://zy.heitaodj.com/api.php/provide/vod/?ac=listhttps://zy.heitaodj.com/api.php/provide/vod/?ac=detail&h=24https://zy.heitaodj.com/api.php/provide/vod/?ac=detail&pagesize=100&pg=1按分类取:在地址后面加 &t=分类ID。取指定影片:加 &ids=影片ID,多个 ID 用英文逗号隔开。
参数说明
- ac
- 不填或填 list:列表模式,只有片名、分类、更新时间等简要字段,并附分类表。填 detail:详情模式,带简介、封面和播放地址(填 videolist 效果相同)。
- t
- 分类 ID,只取这个分类。要填二级分类 ID,填一级分类取不到数据。
- pg
- 页码,从 1 开始。
- pagesize
- 每页条数,默认 20,最多 100。
- h
- 只取最近若干小时内更新的,例如 h=24。
- ids
- 影片 ID,多个用英文逗号隔开。一次超过 20 个时,记得加大 pagesize 或者翻页。
- wd
- 按片名关键词模糊搜索。
- sort_direction
- 按更新时间排序。不填是从新到旧,填 asc 是从旧到新。
- at
- 填 xml 返回 XML;不填返回 JSON。
返回数据
- page / pagecount
- 当前页码 / 总页数。
- limit / total
- 每页条数 / 总条数。XML 里对应 pagesize 和 recordcount。
- class
- 分类表,只在列表模式返回。
- vod_play_from
- 播放组标识,本站是 zym3u8。
- vod_play_url
- 播放地址,格式是「第1集$地址#第2集$地址」:集名和地址用 $ 隔开,集与集用 # 隔开。多个播放组之间用 $$$ 隔开,本站目前只有一组。
- vod_pic
- 封面图地址。
- vod_time
- 最后更新时间,北京时间(UTC+8)。
- XML 格式
- 字段名不同:更新时间叫 last,封面叫 pic,播放地址在 dl 下的 dd 里,dd 的 flag 属性就是播放组标识。
常见问题
采集前请留意
采到了影片,前台却没有播放列表?
采集时你的站点还没有 zym3u8 播放器,播放地址在入库那一步就被丢掉了。先照第 3 步导入播放器、清理缓存,再重新「采全部」一遍。苹果CMS 默认的二次更新规则会把播放地址补上;如果你改过「二次更新规则」,要确认勾选了播放地址。
为什么列表没有数据?
先确认 t 填的是二级分类 ID,一级分类下没有直接挂影片。再看页码有没有超过 pagecount,h 的时间范围是不是太短。
传了很多 ids,怎么只回来 20 条?
默认每页 20 条。加上 pagesize=100,或者翻页取剩下的。
多久请求一次合适?
两次请求之间间隔 1 秒以上。请求太快会被暂时限制(返回 429),停几秒会自动恢复。日常按 h=24 增量采集,不要反复拉全量。
采集时提示接口连不上?
先在浏览器里打开第 1 步的地址,看能不能返回数据。能打开的话,再检查你的服务器能不能访问外网、PHP 有没有开 curl 扩展。
想把封面存到自己服务器?
去苹果CMS 的采集参数配置里找图片同步相关的选项。
如何拿到原始播放地址?
使用 ac=detail,读取返回数据中的 vod_play_url;也可以在本站详情页逐条查看。
用的不是苹果CMS,能采吗?
接口格式与苹果CMS v10 采集接口一致,支持这种格式的程序可以直接用 JSON 或 XML 地址。片源是标准 m3u8,支持 HLS 的播放器都能播。