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 | 否 | integer | 1-搜索id,2-搜索名称 |
search_value | 否 | string | 搜索id或名称内容 |
search_order_type | 否 | integer | 1-上传时间新-旧,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 | 失败 |