Skip to content

视频列表(新)

历史版本

请求路径

  • 请求方式:POST
  • 请求头:Content-Type:application/json
  • 接口地址:https://gateway.nuoyunapi.com/Api/Library/getVideoList/2.0.0
  • 频率限制:10秒30次

请求参数

参数必选类型描述
pageinteger第几页
page_sizeinteger一页显示多少
library_category_one_idinteger一级分类ID
library_category_two_idinteger二级分类ID
statusinteger审核状态:1-正常,2-违规,3-禁用
search_typeinteger1-搜索id,2-搜索名称
search_valuestring搜索id或名称内容
search_order_typeinteger1-上传时间新-旧,2-上传时间旧-新,3-文件名称A-Z,4-文件名称Z-A,5-文件大小大-小,6-文件大小小-大
add_begin_timeinteger开始时间(时间戳:秒级)
add_over_timeinteger结束时间(时间戳:秒级)
room_idinteger直播间ID

请求示例

json
{
    "page": 1,
    "page_size": 10,
    "library_category_one_id": 1,
    "library_category_two_id": 2,
    "status": 1,
    "search_type": 2,
    "search_value": "示例视频",
    "search_order_type": 1,
    "add_begin_time": 1672531200,
    "add_over_time": 1675209600
}

响应参数

参数必选类型描述
codeinteger状态码:200-成功,400-失败
msgstring提示信息
dataobject消息内容

data 参数结构

参数必选类型描述
totalinteger总数量
listarray视频列表

list 参数结构

参数必选类型描述
idinteger素材id
uidinteger账户id
video_namestring视频名称oss名称
upload_namestring视频原名称
formatstring视频格式
pathstring上传文件URL
add_timeinteger添加时间(时间戳:秒级)
sizeinteger文件大小
class_idstring上传文件分类
file_markstring上传文件标记
file_idstring视频id
vod_urlstring视频URL
snap_urlstring封面URL
video_durstring视频时长
video_typestring视频文件类型来源transcode:上传转码vod:直播回放edit:剪辑合并cme_edit:视频精剪
bitrateinteger视频码率
view_numinteger播放量
is_deleteinteger是否删除1:已删除 2:正常
statusinteger审核状态:0-未审核,1-正常,2-违规,3-禁用
library_category_one_idinteger素材1级类别
library_category_two_idinteger素材2级类别
create_timestring创建时间
update_timestring更新时间
task_idstring任务ID
task_typeinteger任务类型1:transcode表上传视频mp4/flv转hls 2:vodflag表回放视频hls转hls 3:vodflag表回放视频hls转mp4 4:音频内容审核 5:点播视频云剪辑
transcoding_viewinteger视频转码进度查看 1-是,2否
edit_statusinteger视频剪辑状态 1:正常 2:剪辑中 3:上传转码中 4:转码中 5:hls视频修复中 6:生成下载地址中 10:任务出错
download_urlstring下载地址
is_play_backinteger是否是回放视频 1:是,2:否(只有传入直播间的时候该字段生效)

响应示例

json
{
    "data": {
        "total": 100,
        "list": [
            {
                "id": 10001,
                "uid": 12345,
                "video_name": "example_video_20250101120000",
                "upload_name": "示例视频名称.mp4",
                "format": "MP4",
                "path": "https://example.vod-qcloud.com/example/video123456/sample.mp4",
                "add_time": 1672531200,
                "size": 52428800,
                "class_id": "100001",
                "file_mark": "ExampleFileMarkABC123==",
                "file_id": "1234567890123456789",
                "vod_url": "https://example.vod-qcloud.com/example/video123456/v.f100240.m3u8",
                "snap_url": "https://example.vod-qcloud.com/example/video123456/cover.jpg",
                "video_dur": "00:15:30",
                "video_type": "transcode",
                "bitrate": 1024000,
                "view_num": 1588,
                "is_delete": 2,
                "status": 1,
                "library_category_one_id": 1,
                "library_category_two_id": 2,
                "create_time": "2025-01-01 12:00:00",
                "update_time": "2025-01-01 12:15:30",
                "task_id": "example-task-id-abc123def456",
                "task_type": 1,
                "transcoding_view": 2,
                "is_play_back": 2,
                "edit_status": 1,
                "download_url": "https://example.vod-qcloud.com/example/video123456/download.mp4"
            }
        ]
    },
    "msg": "Success",
    "code": 200
}

状态码说明

状态码描述
200成功
400失败