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