接口使用说明

四步开始采集

接口无需登录,格式与苹果CMS v10 采集接口一致,默认返回 JSON,也可以取 XML。下面按苹果CMS 后台的操作顺序来写。

01

添加采集地址

JSON 采集地址(推荐)https://zy.heitaodj.com/api.php/provide/vod/
XML 采集地址https://zy.heitaodj.com/api.php/provide/vod/?at=xml

在苹果CMS 后台「采集 → 自定义接口」里点「添加」,照下面填:

资源名称
自己起一个名字,方便区分。必填。
接口地址
上面的 JSON 采集地址。
接口类型
JSON。如果填的是 XML 地址,这里选 XML。
资源类型
视频。
数据操作
新增+更新。
02

绑定分类

在自定义接口列表里点开本站,会列出下表这些分类。逐个点「绑定」,对应到你自己站点的分类。没绑定的分类,采集时会整条跳过。

影片都挂在二级分类下,也就是上级 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
03

添加播放器

本站只有一个播放组,标识是 zym3u8,片源是 m3u8 直链,不需要解析。没有这个播放器的话,采集时会直接把播放地址丢掉,所以一定要在开始采集之前导入。

mac_zym3u8.txt(苹果CMS 播放器导入文件) 下载播放器文件
  1. 后台「视频 → 播放器」,点「导入」,选刚下载的文件,保存。
  2. 点后台右上角的「清理缓存」。

这个文件用的是苹果CMS 自带的 DPlayer,不依赖本站服务器。想手动添加也可以:编码填 zym3u8,解析状态选禁用,其余照自带的 DPlayer 播放器填。已经有 zym3u8 播放器的站点不用重复导入,导入会覆盖同名配置。

04

开始采集

第一次用「采全部」拉全量;之后每天用「采当天」补新片就够了,也可以在后台「定时挂机」里设成自动采集。

示例

常用地址

分类表和最新列表https://zy.heitaodj.com/api.php/provide/vod/?ac=list
最近 24 小时更新的详情https://zy.heitaodj.com/api.php/provide/vod/?ac=detail&h=24
全量翻页,每页 100 条https://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 的播放器都能播。