文档中心 云点播 批量获取素材列表信息

批量获取素材列表信息

更新时间:2022-10-26 17:47:54

素材列表查询

描述

查询素材幕列表,按照上传时间倒序排序。

请求说明

请求方式 Post
接口地址 https://open.chinanetcenter.com/vod/material/getMaterialList
Content-Type 仅支持application/json
是否需要凭证 鉴权方式V3

请求参数

参数名 类型 是否必填 描述
materialId string 素材ID
materialName string 素材名称(模糊查询)
suffix string 素材后缀
createUser string 创建用户
publishDomain string 发布域名
uploadTimeStart int 查询开始时间,根据上传时间查询,秒级时间戳,不得晚查询结束时间。
uploadTimeEnd int 查询结束时间,根据上传时间查询,秒级时间戳,不得早于查询开始时间。
pageIndex int 取素材列表第几页,从1开始取值,默认为1。
pageSize int 平均每页素材数量,取值范围1-50,默认为10。

返回参数

通用返回结果详见返回结果
成功时返回的data参数的数据结构

参数名 类型 描述
total string 符合查询条件的素材总个数
materialList array 素材列表

materialList数组元素的数据结构

参数名 类型 描述
id string 素材ID
name string 素材名称
suffix string 文件后缀
fileSize long 文件大小(单位为bit)
url string 文件url
createUser string 创建用户
createTime int 创建时间

示例

输入示例

curl -X POST  http://open.chinanetcenter.com/vod/material/getSubtitleList 
  -H 'content-type: application/json' 
  -H "Host: open.chinanetcenter.com" 
  <公共的头部参数>
  <自定义的头部参数>
  -d '{"pageIndex":"1","pageSize":"3"}'

输出示例

{
    "code": 200,
    "data": {
        "materialList": [
            {
                "createTime": 1563429555,
                "createUser": "ovptest",
                "fileSize": 1794,
 				"id": "03a9caea016c10009634a00200000000",
				"name": "test01",
                "suffix": "jpg",
                "url":"http://ovptest.haplat.net/cloudv-material/20190718/03a9caea016c10008sd1276200000000.jpg"
            }
			{
                "createTime": 1563429556,
                "createUser": "ovptest",
                "fileSize": 1794,
 				"id": "03a9caea016c1000963hj00200000000",
				"name": "test02",
                "suffix": "jpg",
                "url":"http://ovptest.haplat.net/cloudv-material/20190718/03a9caea016c100084bf276200000000.jpg"
            }
			{
                "createTime": 1563429557,
                "createUser": "ovptest",
                "fileSize": 1794,
 				"id": "03a9caea016c1000963ao00200000000",
				"name": "test03",
                "suffix": "jpg",
                "url":"http://ovptest.haplat.net/cloudv-material/20190718/03a9caea016c1000bjf1276200000000.jpg"
            }
        ],
        "total":3
    },
    "message": "操作成功"
}


错误码

以下仅列出了接口业务逻辑相关的错误码,通用错误码详见 返回结果

错误码 描述
1301 用户无权限
1004 参数错误,请确保所有必填项都已经填写
1000 素材id不存在
1407 开始时间不能大于结束时间
本篇文档内容对您是否有帮助?
有帮助
我要反馈
提交成功!非常感谢您的反馈,我们会继续努力做到更好!