下载中心的数据入库和删除视频管理的视频

通过API直接将需要下载的视频M3U8、封面等下载链接,包括视频详细信息一起导入下载。

下载中心添加数据

POST /api/downloadm3u8

body: {
    #必填参数
    apikey, //转码设置获取
    name, //视频名称,下载完成后自动入库到视频管理的视频名称
    url,  //下载链接,注意如果地址包含&等特殊符号,如果影响到使用,记得转义下
    type,  //下载类型,如m3u8、downloadall、video,且m3u8仅支持下载m3u8链接,video支持mp4、mkv等视频直链,downloadall支持m3u8、mp4、mkv等视频直链和youtube视频地址下载,建议下载M3U8首选m3u8类型,m3u8类型出错就使用downloadall类型下载M3U8。

    #可选参数,如用不到相关参数可不用传递
    poster,  //封面链接,封面仅支持jpg、png、jpeg、webp格式,下载转码后,会自动转换成封面1和封面2;如不填会自动生成封面。
    category, //视频分类,不存在会自动创建
    clientId, //传递一个数据库id,即客户端辨识视频id,当使用通知接口返回信息的时候会返回该id,让你对应并进行数据填充。
    geturl, //解析接口配置,设置详情看下方
    originaltitle, //视频原名
    aka, //视频别名
    language, //语言
    banben, //版本,如HD、高清等
    director, //导演,多个导演用英文逗号,分开,如导演1,导演2,导演3
    stars, //主演,多个主演用英文逗号,分开,如主演1,主演2,主演3
    writer, //编剧,多个编剧用英文逗号,分开,如编剧1,编剧2,编剧3
    tags, //分类标签,多个标签用英文逗号,分开,如剧情,悬疑,搞笑
    summary, //视频简介
    country, //发行地区
    year, //发行年份
    rate, //豆瓣评分

    #可选参数,可自动入库到剧集,下面3个都必填,如用不到可不用传递;且剧集id可以使用剧集api添加后获取
    autodownTv, //剧集id,填入后,会在转码完成时,自动添加进剧集
    autodownepisodes, //集数,如 01,会在添加进剧集后,自动排序;集数命名要规范,位数和总集数一致,如总集数2位数,则用01、10,3位数用001、010。
    tvepisodesname, //集数,如 01,
}

response: {
    success: 1|0,  //1成功,0失败
    id //下载中心数据id,可用于更新api
}

#curl命令使用示例
curl http://127.0.0.1:3000/api/downloadm3u8 -d "name=西游记&category=动作片&url=http://127.0.0.1:8080/1.m3u8&apikey=5c20cEga&type=m3u8&poster=http://127.0.0.1:8080/1.jpg

注意部分参数的格式,切勿乱填,且导入成功后,部分信息不会显示在下载中心,直到下载完成后,会自动将你填入的所有信息入库到视频管理。

解析接口配置

如果获取到的m3u8需要配合解析接口使用,那么得填入解析接口配置,格式为:解析参数$解析接口

比如我获取到的m3u8链接为:http://127.0.0.1:8080/1.m3u8,解析接口为:http://127.0.0.1:3000/api?url=

然后访问解析m3u8的地址,如:http://127.0.0.1:3000/api?url=http://127.0.0.1:8080/1.m3u8,返回json数据如下:

{
    code: '200',
    url: 'http://127.0.0.1:8080/9.m3u8',
    type: 'hls'
}

url参数为解析后获取到的m3u8链接,那么解析接口配置就填入:url$http://127.0.0.1:3000/api?url=,最后下载的时候,会提取解析后的m3u8进行下载。

下载中心修改数据

POST /api/updatedownload

body: {
    #必填参数,且id和name二选一,只需要传递一个参数即可,用来匹配指定数据
    apikey, //转码设置获取
    id, // 下载中心数据ID
    name, // 视频名称

    #可选参数,如用不到相关参数可不用传递
    url,  //下载链接,注意如果地址包含&等特殊符号,如果影响到使用,记得转义下
    type,  //下载类型,如m3u8、downloadall、video,且m3u8仅支持下载m3u8链接,video支持mp4、mkv等视频直链,downloadall支持m3u8、mp4、mkv等视频直链和youtube视频地址下载,建议下载M3U8首选m3u8类型,m3u8类型出错就使用downloadall类型下载M3U8。
    poster,  //封面链接,封面仅支持jpg、png、jpeg、webp格式,下载转码后,会自动转换成封面1和封面2;如不填会自动生成封面。
    category, //视频分类,不存在会自动创建
    clientId, //传递一个数据库id,即客户端辨识视频id,当使用通知接口返回信息的时候会返回该id,让你对应并进行数据填充。
    geturl, //解析接口配置,设置详情看下方
    originaltitle, //视频原名
    aka, //视频别名
    language, //语言
    banben, //版本,如HD、高清等
    director, //导演,多个导演用英文逗号,分开,如导演1,导演2,导演3
    stars, //主演,多个主演用英文逗号,分开,如主演1,主演2,主演3
    writer, //编剧,多个编剧用英文逗号,分开,如编剧1,编剧2,编剧3
    tags, //分类标签,多个标签用英文逗号,分开,如剧情,悬疑,搞笑
    summary, //视频简介
    country, //发行地区
    year, //发行年份
    rate, //豆瓣评分

    #可选参数,可自动入库到剧集,下面3个都必填,如用不到可不用传递;且剧集id可以使用剧集api添加后获取
    autodownTv, //剧集id,填入后,会在转码完成时,自动添加进剧集
    autodownepisodes, //集数,如 01,会在添加进剧集后,自动排序;集数命名要规范,位数和总集数一致,如总集数2位数,则用01、10,3位数用001、010。
    tvepisodesname, //集数,如 01,
}

response: {
    success: 1|0, // 1成功,0失败
    data: [] // 当name对应多条记录时,返回所有匹配的记录ID和name
}

#curl命令使用示例
curl -X POST http://127.0.0.1:3000/api/updatedownload -d "name=西游记&category=动作片&poster=http://127.0.0.1:8080/2.jpg"

注意部分参数的格式,切勿乱填,更新成功后,下载状态均会设置成等待下载

全部数据获取

#apikey在转码设置下方获取
GET /api/downloadlist?apikey=TBG47Y5X7UQ //默认获取下载中心所有的数据信息,且pagecount为总页数,默认每页20个数据

#可选参数
page //页数,默认为第1页
status //状态,默认为全部,且只能为:下载完成、下载出错、等待下载

#带参数的请求参考
GET /api/downloadlist?apikey=TBG47Y5X7UQ&page=1&status=下载出错

删除视频管理的视频

#该操作会将视频管理的指定视频数据和切片全删除,仅支持删除单个数据
delete: /apifluent/delete

data: {
  apikey,
  apisecret,
  id //视频管理的视频id
  originalname //视频管理的视频名称,如有多个同名数据,会一起删除
}

{
  "success": 1|0  //1为删除成功
}

apikeyapisecret必传,idoriginalname传一个即可。

批量删除视频管理的视频

#该操作会批量删除视频管理的指定视频数据和切片
POST: /apifluent/batchdelete

data: {
apikey,
apisecret,
items: [
    { id: "视频ID1" },
    { id: "视频ID2" },
    { originalname: "视频名称1" },
    { originalname: "视频名称2" },
]
}

{
"success": 1,
"message": "批量删除任务已开始处理"
}

apikeyapisecret必传,同视频的idoriginalname只需传一个即可,且多个视频idoriginalname可混合传递,默认每5个一组进行处理。