5. 专辑管理

Posted 2020-11-18

5.专辑管理接口

5.1.创建直播专辑

创建直播专辑（课程）。
会根据课时数量自动创建该课程下的课时。

• 请求

  /album/addLive

  参数：

  catalog_id 【必选】分类编号
  user_id 【必选】用户编号，谁创建的该资源
  name 【必选】名称
  item_num 【必选】资源数量（课时数）
  cover 封面url
  price 价格
  start_time 课程开课日期
  end_time 课程结束日期

• 响应
  {
  "code": 0,
  "err_desc": "6"
  }

5.2.创建点播专辑

创建点播专辑（课程）。
会根据课时数量自动创建该课程下的课时。

• 请求

  /album/addVod

  参数：
  同直播专辑

• 响应

  {
          "code": 0,
          "err_desc": "6"
  }

5.3.查询专辑列表

查询某个用户的所有专辑。

• 请求

  /album/list

  参数：
  user_id 【必选】用户编号
  type 类型，忽略查询所有。0 表示查询点播专辑，1表示查询直播专辑。
  page
  page_size

• 响应

      {
          "code": 0,
          "data": {
              "page": 2,
              "page_size": "2",
              "pages": 4,
              "total": 7,
              "count": 2,
              "ts": 1529057248,
              "items": [
                  {
                      "id": "3",
                      "catalog_id": "101",
                      "user_id": "2",
                      "name": "直播颗2",
                      "item_num": "10",
                      "cover": null,
                      "mediatype": "1",
                      "price": "0.00",
                      "start_time": null,
                      "end_time": null,
                      "add_time": "2018-06-15 16:20:09",
                      "update_time": "2018-06-15 16:20:09",
                      "status": "1"
                  },
                  {
                      "id": "4",
                      "catalog_id": "101",
                      "user_id": "2",
                      "name": "直播颗3",
                      "item_num": "10",
                      "cover": null,
                      "mediatype": "1",
                      "price": "0.00",
                      "start_time": null,
                      "end_time": null,
                      "add_time": "2018-06-15 16:20:12",
                      "update_time": "2018-06-15 16:20:12",
                      "status": "1"
                  }
              ]
          }
      }

5.4.查询一个专辑信息

查询某个专辑的信息。
与上一接口（列表接口）对比，查询单个专辑时会返回详细介绍信息maintext

• 请求
  /album/get
  参数：
  id 编号

• 响应

      {
          "code": 0,
          "data": {
              "count": 1,
              "ts": 1529057402,
              "items": [
                  {
                      "id": "1",
                      "catalog_id": "101",
                      "user_id": "2",
                      "name": "三年级语文",
                      "maintext": null,
                      "cover": null,
                      "mediatype": "0",
                      "price": "0.00",
                      "start_time": null,
                      "end_time": null,
                      "add_time": "2018-06-15 15:50:18",
                      "update_time": "2018-06-15 15:50:18",
                      "status": "1",
                      "item_num": "10"
                  }
              ]
          }
      }

5.5.修改一个专辑信息

• 请求
  /album/edit
  参数：
  id 【必选】 编号
  可修改属性：
  catalog_id 分类编号
  name 名称
  item_num 资源数量（课时数）
  cover 封面url
  price 价格
  start_time 课程开课日期
  end_time 课程结束日期

• 响应

  {
          "code": 0,
  }