接口规范5.点播流相关接口-创新互联

5.点播流相关接口

5.1.查询点播流

• 用途
  查询某个应用下的点播视频流。
  如果查询的是点播应用（如"vod"），返回的是该点播应用下的点播流列表。
  如果查询的是直播应用（如“liveshow”），则会返回的是有录制数据的历史直播流的列表，列表中的时长、修改时间、生成时间属性都是针对该流最后一个录制版本的描述。可以通过下一个接口查询某个直播流下的详细录制数据。

  

  创新互联建站是一家集网站建设,那坡企业网站建设,那坡品牌网站建设,网站定制,那坡网站建设报价,网络营销,网络优化,那坡网站推广为一体的创新建站企业，帮助传统企业提升企业形象加强企业竞争力。可充分满足这一群体相比中小企业更为丰富、高端、多元的互联网需求。同时我们时刻保持专业、时尚、前沿，时刻以成就客户成长自我，坚持不断学习、思考、沉淀、净化自己，让我们为更多的企业打造出实用型网站。

• 请求
  streamMgr/?request=get_streams&application=vod&pageno=1&page_size=20
  application应用名
  pageno页码
  page_size分页大小，【保留】，该参数暂不支持传入，分页大小由服务器根据数据量自动分页。
  在视频流较多的情况下，可以通过传入页码参数请求某一范围内的数据。返回的数据中含有详细的分页信息，可以通过请求第一页获取数据总量和分页的详情。
  本文档的后续章节将不再对分页属性做解释。

• 响应

  {
  "code":0,
  "data":{
      "page":1,
      "page_size":"20",
      "pages":"2",
      "total":"28",
      "modify_time":"1515731044",
      "count":20,
      "items":[
          {
              "seq":1,
              "application":"vod",
              "stream":"fk7cpizvhwshjnyu",
              "type":"movie",
              "starttime":"1515155078",
              "modifytime":"1515155078",
              "active":"no",
              "duration":"10",
              "formats":"flv,hls,mp4"
          },
          {
              "seq":2,
              "application":"vod",
              "stream":"VID20160916153947",
              "type":"movie",
              "starttime":"1515154953",
              "modifytime":"1515154953",
              "active":"no",
              "duration":"36",
              "formats":",,mp4"
          } ]
  }
  }

  返回应用下的点播流。
  data元素下包含数据量和分页信息：
  page当前页码
  pages总页数
  page_size分页大小
  total总数据条数
  count当前分页中的数据条数
  items元素下包含0或多条点播数据流，每条记录的属性如下：
  application应用名
  stream流名称
  type点播流类型,movie表示是视频点播流，live表示是直播流（由直播流形成的归档数据）。
  modifytime最后修改的时间戳
  "starttime开始生成的时间戳，对于movie类型的流，表示转码生成的时间，对于live类型的流表示录制的时间。
  duration视频流的播出时长，单位 秒
  formats视频流的格式，一个视频流可以有多种格式，多种格式之间使用逗号分开，可以是flv、hls、mp4格式中的一种或多种。

5.2.查询直播流录制数据

• 用途
  查询某个直播流的录制数据，录制数据也是一种点播流，是录制直播流形成的点播数据。
  一个直播流每次启停都会生一份录制数据，多次启停后会在一个直播流下生成多份录制数据。直播流的录制数据使用版本号区分，版本号从0开始，每生成一个新文件版本号会增1。

• 请求
  streamMgr/?request=get_stream_files&application=liveshow&stream=jgdy&pageno=1&page_size=20
  application应用名
  stream直播流名称
  pageno页码
  page_size分页大小

• 响应

  {
  "code":0,
  "data":{
      "page":1,
      "page_size":"20",
      "pages":"1",
      "total":"2",
      "modify_time":"1515755949",
      "count":2,
      "items":[
          {
              "version":"1",
              "size":"28759864",
              "duration":"353",
              "starttime":"1515655308",
              "modifytime":"1515655659",
              "formats":"hls"
          },
          {
              "version":"0",
              "size":"121345164",
              "duration":"1209",
              "starttime":"1515218380",
              "modifytime":"1515219588",
              "formats":"hls"
          }
      ]
  }
  }

  返回某个直播流的录制数据。
  items元素下包含0或多条录制数据，每条数据的属性如下：
  version版本号
  size录制数据大小，单位 字节
  duration视频流的播出时长，单位 秒
  modifytime最后修改的时间戳，可以理解成录制结束的时间戳
  "starttime开始录制的时间戳。
  formats视频流的格式，一个视频流可以有多种格式，多种格式之间使用逗号分开，可以是flv、hls、mp4格式中的一种或多种。

5.3.删除视频流

• 用途
  删除一个视频流。
  如果请求删除的是一个视频点播流名称（如"vod"应用下的某个流），会把这个点播流下的视频数据删除掉。
  如果请求的是一个直播流名称，则会把这个直播流下的所有版本的录制数据删除。要删除直播流的某个版本的录制数据，使用下一个接口（删除录制数据）。

• 请求
  streamMgr/?request=remove_stream&application=vod&stream=fk7cpizvhwshjnyu
  application应用名
  stream流名称

• 响应

  {
  "code":0
  }

5.4.删除录制数据

• 用途
  删除某个直播流的某个版本的录制数据。
  要删除所有版本的录制数据，请使用上一接口（删除视频流）；

• 请求
  streamMgr/?request=remove_stream_version&application=liveshow&stream=yellow&version=31
  application应用名
  stream流名称
  version录制版本号

• 响应

  {
  "code":0
  }

创新互联www.cdcxhl.cn，专业提供香港、美国云服务器，动态BGP最优骨干路由自动选择，持续稳定高效的网络助力业务部署。公司持有工信部办法的idc、isp许可证， 机房独有T级流量清洗系统配攻击溯源，准确进行流量调度，确保服务器高可用性。佳节活动现已开启，新人活动云服务器买多久送多久。