简要描述:

  • 获取用户账号下所有视频

访问权限

账号类型 是否有权限
主账号
子账号

接口URL:

http://api.zmengzhu.com/business/v1/media/list

请求方式:

GET

返回结果格式:

JSON

参数:

参数名 是否必须 类型 默认 说明
offset int 0 开始位置
limit int 10 每页数量,每页最大数量100
name string 视频名称关键词
start_at string 视频生成时间开始时间点 如 2021-01-01 11:00:00
end_at string 视频生成时间结束时间点 如 2021-01-01 12:00:00
webinar_id int 直播活动id
video_name string 视频流名称
ticket_id int 视频活动id

返回示例:

响应成功JSON示例:

{
  "code": 200,
  "msg": "ok",
  "data": {
    "list": [
      {
        "id": "28180", // 视频ID
        "uid": "100000819",  // 所属用户UID
        "name": "我是直播视频", // 视频名称
        "introduction": "", // 视频介绍
        "merge_id": "", // 视频合并ID
        "cover_url": "http://s1.zmengzhu.com/upload/img/0c/dc/xxxyyyzz.jpeg", // 封面
        "video_url": "http://vod-o.dev.zmengzhu.com/abc/def/ghijkghijkghijkghijk.m3u8", // 视频播放地址
        "stream": "ghijkghijkghijkghijkghijk", // 关联直播流地址 上传视频流信息
        "duration": "3600", // 视频时长
        "source": "1", // 视频来源 1:频道生成 2:自传视频
        "is_head": "1", // 是否源头视频 0:否 1:是
        "is_cut": "0", // 是否裁剪视频 0:否 1:是
        "space_used": "10454769551", // 视频占用空间大小 单位字节
        "webinar_id": "1546", // 视频源直播活动ID
        "is_deleted": "0", // 是否已删除 0:否 1:是
        "deleted_at": "0", // 删除时间
        "created_at": "1614089463", // 创建时间
        "updated_at": "0", // 最后更新时间
        "trans_state": "0", // 转码状态 0:未转码 1:已转码
        "relation_num": "1" // 视频关联活动数量
      }
    ],
    "total": 1
  }
}

字段说明:

参数名 说明
code 成功为200
msg 成功返回ok
id 视频ID
uid 所属用户UID
name 视频名称
introduction 视频介绍
merge_id 视频合并ID
cover_url 封面
video_url 视频播放地址
stream 关联直播流地址
duration 视频时长
source 视频来源 1:频道生成 2:自传视频
is_head 是否源头视频 0:否 1:是
is_cut 是否裁剪视频 0:否 1:是
space_used 视频占用空间大小 单位字节
webinar_id 视频源直播活动ID
is_deleted 是否已删除 0:否 1:是
deleted_at 删除时间
created_at 创建时间
updated_at 最后更新时间
trans_state 转码状态 0:未转码 1:已转码
relation_num 视频关联活动数量

错误时返回:

{
    "code": 20001,
    "msg": "签名校验失败",
    "data": {}
}