诺云开放平台

Appearance

视频列表（新） ​

历史版本 ​

请求路径 ​

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

请求参数 ​

参数必选类型描述
page是integer第几页
page_size是integer一页显示多少
library_category_one_id否integer一级分类ID
library_category_two_id否integer二级分类ID
status否integer审核状态：1-正常，2-违规，3-禁用
search_type否integer1-搜索id，2-搜索名称
search_value否string搜索id或名称内容
search_order_type否integer1-上传时间新-旧，2-上传时间旧-新，3-文件名称A-Z，4-文件名称Z-A，5-文件大小大-小，6-文件大小小-大
add_begin_time否integer开始时间（时间戳：秒级）
add_over_time否integer结束时间（时间戳：秒级）
room_id否integer直播间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
}

响应参数 ​

参数必选类型描述
code是integer状态码：200-成功，400-失败
msg是string提示信息
data是object消息内容

data 参数结构 ​

参数必选类型描述
total是integer总数量
list是array视频列表

list 参数结构 ​

参数必选类型描述
id是integer素材id
uid是integer账户id
video_name是string视频名称oss名称
upload_name是string视频原名称
format是string视频格式
path是string上传文件URL
add_time是integer添加时间（时间戳：秒级）
size是integer文件大小
class_id是string上传文件分类
file_mark是string上传文件标记
file_id是string视频id
vod_url是string视频URL
snap_url是string封面URL
video_dur是string视频时长
video_type是string视频文件类型来源transcode:上传转码vod:直播回放edit:剪辑合并cme_edit:视频精剪
bitrate是integer视频码率
view_num是integer播放量
is_delete是integer是否删除1：已删除 2：正常
status是integer审核状态：0-未审核，1-正常，2-违规，3-禁用
library_category_one_id是integer素材1级类别
library_category_two_id是integer素材2级类别
create_time是string创建时间
update_time是string更新时间
task_id是string任务ID
task_type是integer任务类型1:transcode表上传视频mp4/flv转hls 2:vodflag表回放视频hls转hls 3:vodflag表回放视频hls转mp4 4:音频内容审核 5:点播视频云剪辑
transcoding_view是integer视频转码进度查看 1-是，2否
edit_status是integer视频剪辑状态 1:正常 2:剪辑中 3:上传转码中 4:转码中 5:hls视频修复中 6:生成下载地址中 10:任务出错
download_url是string下载地址
is_play_back是integer是否是回放视频 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失败