6.资源(课时)管理接口-创新互联

6.资源管理接口

6.1.创建资源(课时)

创建一个资源。
直播专辑下创建直播资源;点播专辑下创建点播资源。
直播资源与点播资源的主要区别是,直播资源有“开始时间”和“结束时间”属性。

集安网站制作公司哪家好,找创新互联!从网页设计、网站建设、微信开发、APP开发、响应式网站设计等网站项目制作,到程序开发,运营维护。创新互联于2013年成立到现在10年的时间,我们拥有了丰富的建站经验和运维经验,来保证我们的工作的顺利进行。专注于网站建设就选创新互联。
  • 请求
    /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,
        }

另外有需要云服务器可以了解下创新互联cdcxhl.cn,海内外云服务器15元起步,三天无理由+7*72小时售后在线,公司持有idc许可证,提供“云服务器、裸金属服务器、高防服务器、香港服务器、美国服务器、虚拟主机、免备案服务器”等云主机租用服务以及企业上云的综合解决方案,具有“安全稳定、简单易用、服务可用性高、性价比高”等特点与优势,专为企业上云打造定制,能够满足用户丰富、多元化的应用场景需求。


网站题目:6.资源(课时)管理接口-创新互联
网页网址:http://scyanting.com/article/deshho.html