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

描述

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

请求参数

名称	类型	是否必需	描述
Action	String	是	系统规定参数。取值：GetVideoInfo
VideoId	String	是	视频ID

返回参数

名称	类型	描述
RequestId	String	请求ID
Video	Video	视频信息

API示例

请求示例

http://vod.cn-shanghai.aliyuncs.com/?Action=GetVideoInfo&VideoId=93ab850b4f6f44eab54b6e91d24d81d4&Format=JSON&<公共参数>

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

返回示例

JSON格式

    {
     "RequestId": "25818875-5F78-4A13-BEF6-D7393642CA58",
     "Video": {
         "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": {
            "Snapshot":[
                "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"
      }
    }

错误码

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

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

SDK示例

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