采集API配置教程
开启采集api之后,可提供给苹果CMS采集已发布的视频和剧集,包括视频标签、简介等在EFV编辑的所有视频信息。
且后面新增的、或修改过相关信息的视频和剧集均可以自动同步更新到苹果CMS。
即在苹果CMS配置好EFV采集api后,视频上传,标签、简介等数据编辑可全在EFV后台通过豆瓣获取或自行编辑。
采集步骤
开启EFV的采集api并配置正确的域名
提示:转码设置的第一个设置域名选项一定要填写正确,也就是采集过去的M3U8和封面域名。
我们先去EFV后台,前往左侧转码相关,找到对接苹果CMS,点进去可设置采集api。
建议设置采集key,如果你只想给某些人采集,那么还可以设置采集ip白名单,多个ip使用$隔开,如:
#只给ip为123.23.123.123的苹果CMS采集
123.23.123.123
#只给ip为123.23.123.123和132.132.43.12的苹果CMS采集
123.23.123.123$132.132.43.12
#只给ip为123.23.123.123、132.132.43.12和143.154.34.23的苹果CMS采集
123.23.123.123$132.132.43.12$143.154.34.23
然后再前往转码设置,找到最上面的设置域名,填入你EFV绑定的域名地址,也就是采集接口显示的M3U8、截图等域名。
前往苹果CMS后台调整采集参数配置
先进入到苹果CMS后台,点击最上面导航的系统栏目,在左侧找到采集参数配置,大致需要调整的地方如下:

配置说明:
1、入库重复规则,该处默认就行了;注意如果老用户此前使用过第三方CMS发布系统,建议取消掉演员和导演,不然采集数据可能会和发布系统重复。
2、二次更新规则,也就是你在EFV修改过视频和剧集的相关信息的会不会再次同步更新到苹果CMS,可自行设置,也可默认;如果你有剧集,请把连载数、备注和总集数选上。
前往苹果CMS后台设置采集接口
先进入到苹果CMS后台,点击最上面导航的采集栏目,在左侧找到自定义接口,点击添加,设置如下:
提示:接口地址为 EFV绑定域名 + /api/provider/vod/?ac=detail&apiKey=yourkey,yourkey为采集key;如未设置key,则接口地址为/api/provider/vod/?ac=detail

资源名称和接口地址自行设置,接口类型选择JSON,其它和上面截图一样即可,添加好自定义接口后,再点击接口列表已添加的接口地址,如下:

点进去后,在最上面我们会看到EFV的分类信息,如下:

然后点击分类旁边的绑定,选择苹果CMS的分类,这样就可以将EFV的分类视频同步到苹果CMS指定分类下了。
最后回到自定义接口列表,点击右侧的采集全部即可,等待采集完,EFV全部的已发布视频和剧集都会被同步到苹果CMS。

相关说明
注意事项
EFV的视频和剧集一定要设置好分类,且配置接口的时候,EFV分类一定要绑定好苹果CMS的分类,不然未设置或未绑定好分类的视频无法被苹果CMS采集。
EFV默认只有已发布的视频和剧集才能被采集,可先对已转码完成的视频和剧集进行相关编辑后再发布出去;如果你不需要给视频或剧集编辑相关信息,可直接在采集配置页面打开展示有效数据开关即可,就不需要发布了,会自动将转码完成和有集数的剧集发送到接口提供采集。
如果有剧集,建议不要在EFV给剧集的单集设置分类,防止单集被误操作发布出去了,这样苹果CMS会当电影采集下来,不绑定分类,就不会采集误发布的单集
发布视频和剧集的多种方法
视频发布分为单个视频发布、批量发布和全部发布,可前往EFV后台 ⇒ 进入视频管理,进行相关操作,如图:

剧集发布,发布剧集之前,请提前将剧集里面的单集添加到剧集里面,然后找到想要发布的剧集右侧操作选项,点击正式发布即可。
如何给采集接口设置不同的图片和m3u8域名
提示:如果给图片或M3U8单独设置域名,则会覆盖转码设置的设置域名参数,即优先使用。
一般采集接口的M3U8和图片域名默认为转码设置的第一个设置域名参数,如果你有特殊需求,是可以单独进行设置的。
单独设置图片域名
可直接在EFV后台的对接苹果CMS功能设置页面,找到相关设置项进行设置。
单独设置M3U8域名
目前最新版支持自定义M3U8域名,需要直接在采集接口使用参数传递,使用方法如下:
#直接在采集接口后面添加m3u8url参数即可,比如我要指定m3u8域名为https://cdn1.com
/api/provider/vod/?ac=detail&m3u8url=https://cdn1.com
/api/provider/vod/?ac=detail&apiKey=yourkey&m3u8url=https://cdn1.com
#然后你可以浏览器访问接口,检查m3u8域名是否变成了你传入的参数,如不生效则需更新最新版
最后将带M3U8域名参数的接口地址填入到苹果接口配置项即可,且目前图片域名可以直接在后台单独设置。
全英文数据api采集接口
提示:如打开英文数据采集接口显示404,需更新到最新版再使用。
目前提供一个输出英文数据的苹果采集api接口,可用来做纯英文站点,地址:/api/provider/vod/en/?ac=detail,用法参考上面,只需要改一下采集地址即可。
英文数据填充说明:
#视频和剧集的标题、简介
可在视频管理、剧集管理的详细编辑的英文字段填充。
#视频和剧集的语言、导演、主演、编剧、发行地区、分类标签
这些字段均在标签管理,直接前往CMS相关 ⇒ 标签管理进行英文数据填充。
#视频和剧集的分类
可在分类管理进行英文数据填充,分类仅起到绑定分类,并入库苹果cms作用,也可不用翻译。
以上英文数据均可使用ai自动翻译,可前往EFV后台 ⇒ CMS相关 ⇒ 多语言翻译进行操作,如找不到CMS相关入口,可点击左下角侧栏开关,开启CMS导航即可。
最后该英文接口优先显示英文数据,如果部分字段没填充英文数据,则会使用默认的中文数据,推荐结合苹果cms的纯英文模板一起使用。