5. 专辑管理

5.专辑管理接口

5.1.创建直播专辑

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

• 请求

  /album/addLive

  参数：

  catalog_id 【必选】分类编号
  user_id 【必选】用户编号，谁创建的该资源 // 【变】不再需要，取登录用户的id，没有登录也无法创建
  name 【必选】名称
  item_num 【必选】资源数量（课时数）
  cover 封面url
  price 价格
  start_time 课程开课日期，格式： yyyy-mm-dd hh:mm:ss 都需要有前导0
  end_time 课程结束日期，格式： yyyy-mm-dd hh:mm:ss 都需要有前导0

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

5.2.创建点播专辑

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

• 请求

  /album/addVod

  参数：
  同直播专辑

• 响应

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

5.3.查询自己的专辑列表

查询当前登录用户自己的专辑。

• 请求

  /album/list

  参数：
  user_id 【必选】用户编号【变】不再需要，取登录用户的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","buy_num": "0","zan_num": "0","love_num": "0","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","buy_num": "0","zan_num": "0","love_num": "0","start_time": null,"end_time": null,"add_time": "2018-06-15 16:20:12","update_time": "2018-06-15 16:20:12","live_status": 1,"status": "1"}]}}

live_status 直播状态， 1 直播中， 其他表示未直播

5.4.查询所有专辑列表

查询系统中所有的专辑。

• 请求
  /album/all
  参数：
  user_id 【可选】查询按个用户的
  type 类型，忽略查询所有。0 表示查询点播专辑，1表示查询直播专辑。
  catalog_id 分类，定义查询哪个分类下的专辑。

page
page_size

• 响应

• 5.5.查询一个专辑信息

  查询某个专辑的信息。
  与上一接口（列表接口）对比，查询单个专辑时会返回详细介绍信息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","pay_status":2,"live_status": 1,}]}}

pay_status 当前登录用户对该专辑的购买状态。
2 表示已经购买
其他表示未购买。

5.6.修改一个专辑信息

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

• 响应

  {"code": 0,
  }

5.7.赞

响应客户的点赞请求，返回赞的总数。

• 请求
  /album/zan
  参数：
  id 【必选】 编号

• 响应

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

err_desc 点赞总数

5.8.收藏 和 取消收藏

响应客户的收藏请求，返回被收藏的总数。

• 请求
• 收藏
  /album/cang

• 取消收藏
  /album/uncang
  参数：
  id 【必选】 编号

• 响应

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

err_desc 收藏总数

5.9.我的收藏列表

查询我的收藏列表。

• 请求
  /album/mycang
  参数：
  无

• 响应

              {"code": 0,"data": {"count": 2,"ts": 1531649644,"items": [{"id": "7","name": "测试点播2","item_num": "2","start_time": "2018-07-09 16:37:16","end_time": "2018-07-09 16:37:18","cover": "http://img.ruiboyun.net/img/2018-07-09/rxaq5fl0sx17fgd9.png","mediatype": "0","price": "0.01","status": "1"},{"id": "2","name": "测试支付","item_num": "1","start_time": "2018-07-05 19:03:48","end_time": "2018-07-05 19:03:50","cover": "http://img.ruiboyun.net/img/2018-07-09/zbsze16blzzdc7tt.jpg","mediatype": "1","price": "0.01","status": "1"}]}}

5.10.我购买的课程列表

查询我的收藏列表。

• 请求
  /album/mybuy
  参数：
  无

• 响应

              {"code": 0,"data": {"count": 8,"ts": 1531650852,"items": [{"id": "8","name": "我的表演课","item_num": "3","start_time": "2018-07-10 00:00:00","end_time": "2018-07-31 00:00:00","cover": "http://img.ruiboyun.net/img/2018-07-10/cb4b992rbh78hr4x.jpg","mediatype": "0","price": "0.01","status": "1","pay_time": "2018-07-10 17:28:24"},{"id": "7","name": "测试点播2","item_num": "2","start_time": "2018-07-09 16:37:16","end_time": "2018-07-09 16:37:18","cover": "http://img.ruiboyun.net/img/2018-07-09/rxaq5fl0sx17fgd9.png","mediatype": "0","price": "0.01","status": "1","pay_time": "2018-07-11 18:32:55"},{"id": "16","name": "钢琴教学","item_num": "1","start_time": "2018-07-11 00:00:00","end_time": "2018-07-11 00:00:00","cover": "http://img.ruiboyun.net/img/2018-07-11/ugorm2x2pt6x17k4.jpg","mediatype": "0","price": "0.00","status": "1","pay_time": "2018-07-11 18:35:57"},{"id": "20","name": "李斯特","item_num": "1","start_time": "2018-07-11 00:00:00","end_time": "2018-07-11 00:00:00","cover": "http://img.ruiboyun.net/img/2018-07-11/bh9taws68mu50h2u.jpg","mediatype": "0","price": "1.00","status": "1","pay_time": null},{"id": "19","name": "肖邦","item_num": "2","start_time": "2018-07-11 00:00:00","end_time": "2018-07-12 00:00:00","cover": "http://img.ruiboyun.net/img/2018-07-11/admucfl01xsdznwi.jpg","mediatype": "0","price": "0.00","status": "1","pay_time": "2018-07-11 18:42:09"},{"id": "23","name": "月光","item_num": "1","start_time": "2018-07-11 00:00:00","end_time": "2018-07-13 00:00:00","cover": "http://img.ruiboyun.net/img/2018-07-11/8rk6pn506ckrg7cs.jpg","mediatype": "0","price": "0.00","status": "1","pay_time": "2018-07-11 19:06:23"},{"id": "2","name": "测试支付","item_num": "1","start_time": "2018-07-05 19:03:48","end_time": "2018-07-05 19:03:50","cover": "http://img.ruiboyun.net/img/2018-07-09/zbsze16blzzdc7tt.jpg","mediatype": "1","price": "0.01","status": "1","pay_time": "2018-07-11 19:07:21"}]}}

pay_time 购买时间

5.11.查询推荐专辑列表（首页滚动框内的专辑）

查询需要在首页slider框内展示的内容。可能返回0个或多个专辑。

• 请求
  /album/sliders
  参数：
  无

• 响应
  同查询专辑列表。

5.12.申请上线

课程编辑完成后，申请上线。
申请上线后进入正在审核状态，审核通过后正式上线。

• 请求
  /album/pub
  参数：
  id 【必选】 编号

• 权限要求
  老师身份

• 响应

          {"code": 0,}

5.13.下线 或 撤销上线申请

对正在申请审核的课程，使用该接口撤销申请，重新回到编辑状态。
对已经上线的课程，使用该接口下线课程，重新回到编辑状态。

• 请求
  /album/unpub
  参数：
  id 【必选】 编号

• 权限要求
  老师身份

• 响应

          {"code": 0,}

5.13. 审核上线申请

对上线申请进行审核

• 请求
  manage/checkAlbum
  参数：
  id 【必选】 编号
  result 【必选】 审核结果， 1 通过 0 未通过
  comment 审核备注，例如不通过的理由。

• 权限要求
  管理员

• 响应

          {"code": 0,}

5.14.查询首页分类下的专辑列表

查询首页某个分类下的专辑列表，会根据后台配置返回指定数量的专辑。
该接口仅用于首页展示。

• 请求
  /album/some
  参数：
  catalog_id 分类，定义查询哪个分类下的专辑。

• 响应
  同 5.3小节。

转载于:https://blog.51cto.com/livestreaming/2129949

本文来自互联网用户投稿，文章观点仅代表作者本人，不代表本站立场，不承担相关法律责任。如若转载，请注明出处。 如若内容造成侵权/违法违规/事实不符，请点击【内容举报】进行投诉反馈！