5. 专辑管理

最新推荐文章于 2024-09-19 16:33:29 发布

weixin_34387468

最新推荐文章于 2024-09-19 16:33:29 发布

阅读量156

点赞数

原文链接：http://blog.51cto.com/livestreaming/2129949

版权

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