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

6.资源管理接口

6.1.创建资源(课时)

创建一个资源。
直播专辑下创建直播资源;点播专辑下创建点播资源。
直播资源与点播资源的主要区别是,直播资源有“开始时间”和“结束时间”属性。

10年积累的成都网站设计、成都做网站经验,可以快速应对客户对网站的新想法和需求。提供各种问题对应的解决方案。让选择我们的客户得到更好、更有力的网络服务。我虽然不认识你,你也不认识我。但先制作网站后付款的网站建设流程,更有铜陵免费网站建设让你可以放心的选择与我们合作。

  • 请求
    /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,
        }

当前名称:6.资源(课时)管理接口
分享URL:http://myzitong.com/article/igcijg.html