全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网
视频点播

获取视频信息列表

更新时间:2017-11-13 10:17:43

获取视频信息列表

描述

获取视频信息列表。最大支持获取前5000条。

请求参数

名称 类型 必填项 描述
Action String 操作接口名,系统规定参数,取值: GetVideoList
Status String 视频状态,默认获取所有视频,多个可以用逗号分隔,如:Uploading,Normal,取值包括:
Uploading(上传中),UploadFail(上传失败),UploadSucc(上传完成),Transcoding(转码中),TranscodeFail(转码失败),Blocked(屏蔽),Normal(正常)
StartTime String CreationTime(创建时间)的开始时间,为开区间(大于开始时间)。
日期格式按照ISO8601标准表示,并需要使用UTC时间。格式为:YYYY-MM-DDThh:mm:ssZ 例如,2017-01-11T12:00:00Z(为北京时间2017年1月11日20点0分0秒)
EndTime String CreationTime的结束时间,为闭区间(小于等于结束时间)。
日期格式按照ISO8601标准表示,并需要使用UTC时间。格式为:YYYY-MM-DDThh:mm:ssZ 例如,2017-01-11T12:00:00Z(为北京时间2017年1月11日20点0分0秒)
CateId Long 视频分类ID
PageNo Long 页号,默认1
PageSize Long 可选,默认10,最大不超过100
SortBy String 结果排序,范围:CreationTime:Desc、CreationTime:Asc,默认为CreationTime:Desc(即按创建时间倒序)

返回参数

名称 类型 描述
RequestId String 请求ID
VideoList Video[] 视频信息列表
Total Number 视频总条数

特殊错误码

错误代码 错误描述 HTTP状态码 语义
InvalidVideo.NotFound The video does not exist. 404 视频不存在
VideoListExceededMax The video list exceeded maximum. 400 翻页总条数超过最大限制

示例

请求示例

  1. http://vod.cn-shanghai.aliyuncs.com/?Action=GetVideoList&Status=Normal&Format=JSON&<公共参数>

注:示例中的“公共参数”需要有效传参,详情请查看 公共参数说明文档

返回示例

Json:

  1. {
  2. "RequestId": "25818875-5F78-4A13-BEF6-D7393642CA58",
  3. "Total" : 100,
  4. "VideoList":{
  5. "Video" [
  6. {
  7. "VideoId": "93ab850b4f6f44eab54b6e91d24d81d4",
  8. "Title": "阿里云VOD视频标题",
  9. "Description": "阿里云VOD视频描述",
  10. "Duration": 135.6,
  11. "CoverURL": "https://image.example.com/coversample.jpg",
  12. "Status": "Normal",
  13. "CreationTime": "2017-06-26T05:38:48Z",
  14. "Size": 10897890,
  15. "Snapshots": {
  16. "Snapshot":[
  17. "http://image.example.com/snapshot/sample000001.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e273334f52",
  18. "http://image.example.com/snapshot/sample00002.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e272434f52",
  19. ...
  20. ]
  21. },
  22. "CateId": 78,
  23. "CateName": "分类名",
  24. "Tags": "标签1, 标签2"
  25. }
  26. ]
  27. }
  28. }
本文导读目录