批量获取视频信息

最近更新时间:2018-04-02 17:18:38

接口名称

DescribeVodInfo

注意:
该接口已被更完善的服务端 API 替代,参见:GetVideoInfo

功能说明

  1. 根据FileID获取视频属性信息,包括名称、标签、创建时间等。

请求方式

请求域名

vod.api.qcloud.com

最高调用频率

100次/分钟

参数说明

参数名称 必填 类型 说明
fileIds.n String 视频ID列表,暂时不支持批量
from String 开始时间,默认为1970-1-1 00:00:00
to String 结束时间,默认为 2038-1-1 00:00:00
classId Integer 视频分类ID,过滤使用
status Integer 视频状态,过滤使用, -1:未上传完成,不存在;0:初始化,暂未使用;1:审核不通过,暂未使用;2:正常;3:暂停;4:转码中;5:发布中;6:删除中;7:转码失败;100:已删除
orderby Integer 结果排序,默认按时间升序,0:按时间升序 1:按时间降序
pageNo Integer 分页页号
pageSize Integer 分页大小,范围在10-100之间
COMMON_PARAMS 参见公共参数

请求示例

https://vod.api.qcloud.com/v2/index.php?Action=DescribeVodInfo
&fileIds.1=1976554120332374777
&COMMON_PARAMS

接口应答

参数说明

参数名称 类型 说明
code Integer 错误码, 0: 成功, 其他值: 失败
message String 错误信息
totalCount Integer 视频总数
fileSet Array 视频列表结果集

fileSet 视频列表结果集

参数名称 类型 描述
fileId String 视频ID
fileName String 视频名称
size String 视频大小
duration String 视频持续时间
status String 视频状态, -1:未上传完成,不存在;0:初始化,暂未使用;1:审核不通过,暂未使用;2:正常;3:暂停;4:转码中;5:发布中;6:删除中;7:转码失败;10:等待转码;100:已删除
vid String 视频的唯一识别码
createTime String 视频创建时间
updateTime String 视频修改时间
classId String 视频分类ID
className String 视频分类名称
imageUrl String 视频封面图片
tags Array 视频标签列表
description string 描述

错误码说明

错误码 含义说明
4000-7000 参见公共错误码
1 内部错误
1000 无效参数
1001 内部错误
1003 内部错误
2000 内部错误
10008 文件不存在
10022 内部错误

应答示例

{
    "code": 0,
    "message": "",
    "fileSet": [
        {
            "fileId": "1976554120332374777",
            "fileName": "蓝色茉莉(01h35m56s-01h38m23s)",
            "fileIntro": "",
            "size": "7865592",
            "duration": "147",
            "status": "2",
            "vid": "1200_1870483a9a6011e4a137dfa495b17abf",
            "createTime": "2015-01-12 21:37:11",
            "updateTime": "2015-01-13 11:23:01",
            "classId": "0",
            "className": "其他",
            "imageUrl": "http://p.qpic.cn/videoyun/0/1200_1870483a9a6011e4a137dfa495b17abf_1/640",
            "tags": [
                "其他"
            ]
        }
    ]
}