6.资源(课时)管理接口-创新互联
6.资源管理接口
6.1.创建资源(课时)
创建一个资源。
直播专辑下创建直播资源;点播专辑下创建点播资源。
直播资源与点播资源的主要区别是,直播资源有“开始时间”和“结束时间”属性。
- 请求
/res/add?&album_id=2&start_time=2018-06-19%2012:01:02&end_time=2018-06-19%2013:00:00&name=我的直播课
参数:
album_id 【必选】专辑(课程)编号,在按个课程下创建课时。
start_time 在创建直播资源时是必选参数,定义开始直播时间。格式: yyyy-mm-dd hh:mm:ss 都需要有前导0
end_time在创建直播资源时是必选参数,定义结束直播时间。
name 【必选】名称,64个字符以内。
seq 课时序号 ,最小1,大为该课程的总课时数
cover 封面url
maintext 描述信息
响应
{ "code": 0, "err_desc": "6" }
6.2.查询资源列表
- 请求
网站展示:
/res/list?album_id=2
资源管理:
/res/mylist?album_id=2
注:list接口会返回更多数据,包括禁用的和没有绑定播放地址的资源。all接口用于网站显示,只显示有效的可播放的资源。
参数:
album_id 【必选】专辑(课程)编号,查询哪个课时下的课程。响应
{ "code": 0, "data": { "page": 1, "page_size": 100, "pages": 1, "total": 2, "count": 2, "ts": 1529395428, "items": [ { "id": "21", "album_id": "2", "user_id": "2", "mediatype": 1, "name": "我的直播第一课", "seq": 1, "cover": null, "start_time": "2018-06-19 12:00:00", "end_time": "2018-06-19 13:00:00", "kan_num": "0", "zan_num": "0", "duration": null, "size": "0", "add_time": "2018-06-19 15:31:05", "update_time": "2018-06-19 15:31:05", "status": "1", "media_bind": "0" }, { "id": "22", "album_id": "2", "user_id": "2", "mediatype": 1, "name": "我的直播第一课2", "seq": 2, "cover": null, "start_time": "2018-06-19 12:05:05", "end_time": "2018-06-19 13:05:05", "kan_num": "0", "zan_num": "0", "duration": null, "size": "0", "add_time": "2018-06-19 15:47:00", "update_time": "2018-06-19 15:48:47", "status": "1", "media_bind": "0" } ] } }
id: 编号,
album_id: 课程编号,
user_id: 用户编号,
mediatype: 资源类型,0 为点播,1为直播
name: 名称,标题,
seq: 课时序号,
cover: 封面,
start_time: 开始直播时间, 点播课请忽略
end_time: 结束直播时间, 点播课请忽略
kan_num: 收看次数
zan_num: 点赞次数
duration: 时长
size: 文件大小
add_time: 添加时间
status: 状态,定义如下:
0 审核中 1 正常 2 禁用 -1 删除
10 正在处理(如转码中,上传中等)
media_bind: 是否有播放资源绑定,0 表示尚未绑定播放资源,1表示已经绑定播放资源,绑定后可以播放。
live_status 直播状态,1 正在直播, 其他表示未直播
6.3.查询资源
查询某个资源。
- 请求
/res/get?id=2 参数:
id 【必选】课时编号。- 响应
返回结构与查询列表相同,区别是只返回一条记录,并且增加 maintext(详细介绍)属性。
6.4.编辑资源
查询某个资源。
- 响应
- 请求
/res/edit?id=2 参数:
id 【必选】课时编号。
start_time 在创建直播资源时是必选参数,定义开始直播时间。格式: yyyy-mm-dd hh:mm:ss 都需要有前导0
end_time在创建直播资源时是必选参数,定义结束直播时间。
name 名称,64个字符以内。
seq 课时序号 ,最小1,大为该课程的总课时数
cover 封面url
maintext 描述信息响应
{ "code": 0, }
6.5.赞
响应客户的点赞请求,返回赞的总数。
请求
/res/zan
参数:
id 【必选】编号响应
{ "code": 0, "err_desc": 5 }
err_desc 点赞总数
6.6.观看
记录用户观看该资源的次数。
请求
/res/kan
参数:
id 【必选】编号响应
{ "code": 0, "err_desc": 5 }
err_desc 观看总数
6.7. 获取播放地址
记录用户观看该资源的次数。
请求
/res/playUrl
参数:
id 【必选】 资源编号响应
{ "code": 0, "data": { "count": 1, "ts": 1530181471, "items": [ { "hls_url": "http://10.9.12.210/m3u8/vod/29-9b5897.m3u8", "rtmp_url": null, "mp4_url": "" } ] } }
hls_url hls播出地址
rtmp_url rtmp播出地址(直播资源返回)
mp4_url mp4播出地址(点播资源返回)
6.8. 删除资源
请求
/res/delete
参数:
id 【必选】 课时编号响应
{ "code": 0, }
另外有需要云服务器可以了解下创新互联cdcxhl.cn,海内外云服务器15元起步,三天无理由+7*72小时售后在线,公司持有idc许可证,提供“云服务器、裸金属服务器、高防服务器、香港服务器、美国服务器、虚拟主机、免备案服务器”等云主机租用服务以及企业上云的综合解决方案,具有“安全稳定、简单易用、服务可用性高、性价比高”等特点与优势,专为企业上云打造定制,能够满足用户丰富、多元化的应用场景需求。
本文名称:6.资源(课时)管理接口-创新互联
分享URL:http://azwzsj.com/article/deshho.html