GetVideoList - 获取媒资信息列表_智能媒体服务(IMS)-阿里云帮助中心

获取视频信息列表。

接口说明

本接口最多可获取指定筛选条件（如视频状态、分类 ID 等）的前 5000 条音视频。建议限定 StartTime 和 EndTime 来分批获取数据。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
CateId	long	否	分类 ID。	781111
Status	string	否	视频状态。支持获取多个状态的视频，多个状态之间使用半角逗号（,）分隔。枚举值： PrepareFail：文件异常。 UploadFail：上传失败。 UploadSucc：上传完成。 Transcoding：转码。 TranscodeFail：转码失败。 ProduceFail：合成失败。 Normal：正常。 Uploading：上传中。 Preparing：文件生成中。 Blocked：屏蔽。 Checking：审核。	Uploading,Normal
StartTime	string	否	CreationTime（创建时间）的开始时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。	2017-01-11T12:00:00Z
EndTime	string	否	CreationTime 的结束时间，需晚于开始时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。	2017-01-11T12:59:00Z
SortBy	string	否	查询结果排序。取值： CreationTime:Desc（默认值）：按创建时间倒序。 CreationTime:Asc：按创建时间升序。	CreationTime:Asc
PageNo	integer	否	当前页码。默认值为 1。	1
PageSize	integer	否	列表页大小。默认值为 10，最大值为 50。	20

返回参数

名称	类型	描述	示例值
	object	Schema of Response。
RequestId	string	Id of the request。	****11-DB8D-4A9A-875B-275798****
Success	string	是否请求成功。取值： true：成功 false：失败	true
Code	string	返回码。	200
Total	long	符合条件的媒资总数。	163
MediaList	object []	媒资信息列表。
StorageLocation	string	存储地址。	out-****.oss-cn-shanghai.aliyuncs.com
Status	string	视频状态。枚举值： PrepareFail：文件异常。 UploadFail：上传失败。 UploadSucc：上传成功。 Transcoding：转码。 TranscodeFail：转码失败。 ProduceFail：合成失败。 Normal：正常。 Uploading：上传中。 Preparing：文件生成中。 Blocked：屏蔽。 Checking：审核。	Normal
CreationTime	string	创建时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。	2017-11-14T09:15:50Z
CateId	long	分类 ID。	3679
MediaId	string	媒资 ID。	1c6ce34007d571ed94667630a6bc****
Tags	string	标签列表。	标签1, 标签2
ModificationTime	string	更新时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。	2017-11-14T09:16:50Z
CateName	string	分类名称。	分类1
Description	string	描述。	阿里云VOD视频描述
AppId	string	应用 ID。默认取值：app-1000000	app-1000000
Size	long	源文件大小。单位：字节。	10897890
CoverUrl	string	封面 URL。	http://example.aliyundoc.com/snapshot/**.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e27333**
Duration	float	时长。单位：秒。	135.6
Title	string	标题。	史上最牛音乐播放器
Snapshots	array	视频截图 URL 数组。
	string	视频截图 URL。	http://example.aliyundoc.com/snapshot/**.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e27333**

示例

正常返回示例

JSON格式

{
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "Success": "true",
  "Code": "200",
  "Total": 163,
  "MediaList": [
    {
      "StorageLocation": "out-****.oss-cn-shanghai.aliyuncs.com",
      "Status": "Normal",
      "CreationTime": "2017-11-14T09:15:50Z",
      "CateId": 3679,
      "MediaId": "1c6ce34007d571ed94667630a6bc****",
      "Tags": "标签1, 标签2",
      "ModificationTime": "2017-11-14T09:16:50Z",
      "CateName": "分类1",
      "Description": "阿里云VOD视频描述",
      "AppId": "app-1000000",
      "Size": 10897890,
      "CoverUrl": "http://example.aliyundoc.com/snapshot/****.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e27333****",
      "Duration": 135.6,
      "Title": "史上最牛音乐播放器",
      "Snapshots": [
        "http://example.aliyundoc.com/snapshot/****.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e27333****"
      ]
    }
  ]
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间	变更内容概要	操作

暂无变更历史