批量获取视频信息_音视频管理_媒资管理_服务端API

描述

通过视频ID列表获取多个视频的基本信息，包括视频标题、描述、时长、封面URL、状态、创建时间、大小、截图、分类和标签等。

请求参数

名称	类型	是否必需	描述
Action	String	是	系统规定参数。取值：GetVideoInfos
VideoIds	String	是	视频ID列表。多个用逗号分隔，最多支持20个。

返回参数

名称	类型	描述
RequestId	String	请求ID
VideoList	Video[]	视频信息列表
NonExistVideoIds	String[]	不存在的视频ID列表

API示例

请求示例

http://vod.cn-shanghai.aliyuncs.com/?Action=GetVideoInfos&VideoIds=93ab850b4f6f44eab54b6e91d24d81d4,2567850b4f6f44eab54b6e91d24d8gdf&Format=JSON&<公共参数>

注意：示例中的“公共参数”参见公共参数说明文档。

返回示例

JSON格式

{
    "RequestId": "25818875-5F78-4A13-BEF6-D7393642CA58",
    "VideoList": [{
        "VideoId": "93ab850b4f6f44eab54b6e91d24d81d4",
        "Title": "阿里云VOD视频标题",
        "Description": "阿里云VOD视频描述",
        "Duration": 135.6,
        "CoverURL": "https://image.example.com/coversample.jpg",
        "Status": "Normal",
        "CreationTime": "2017-06-26T05:38:48Z",
        "Size": 10897890,
        "Snapshots": [
                "http://image.example.com/snapshot/sample000001.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e273334f52", 
                "http://image.example.com/snapshot/sample00002.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e272434f52", 
                ...
        ],
        "CateId": 78,
        "CateName": "分类名",
        "Tags": "标签1, 标签2"
     },
     ...
     ],
    "NonExistVideoIds":["b4039216985f4312a5382a4ed2884"]
}

错误码

下表列举了本接口特有的错误码。视频点播通用的错误码信息，参见错误码表。

错误代码	错误信息	HTTP 状态码	说明
InvalidVideo.NotFound	The video does not exist.	404	视频不存在。

SDK示例

建议使用服务端SDK 来调用API，此API各语言调用的示例代码，请参考如下：