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,
      }