温馨提示×

温馨提示×

您好,登录后才能下订单哦!

密码登录×
登录注册×
其他方式登录
点击 登录注册 即表示同意《亿速云用户服务条款》

6. 资源(课时)管理接口

发布时间:2020-08-03 23:31:23 来源:网络 阅读:693 作者:sendoffice 栏目:web开发

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,
        }
向AI问一下细节

免责声明:本站发布的内容(图片、视频和文字)以原创、转载和分享为主,文章观点不代表本网站立场,如果涉及侵权请联系站长邮箱:is@yisu.com进行举报,并提供相关证据,一经查实,将立刻删除涉嫌侵权内容。

AI