批量获取素材列表信息

更新时间:2023-04-21 17:50:42

适用产品

云点播

接口描述

调用getMaterialList获取已上传素材的信息列表里

推荐使用 Open API在线调试

Open API在线调试功能提供可视化界面在线调试API、支持生成代码示例、快速检索查看API文档等能力。前往调试

请求参数

Body 参数

参数名称描述
materialIdString
素材ID
materialNameString
素材名称(模糊查询)
suffixString
素材后缀
createUserString
创建用户
publishDomainString
发布域名
uploadTimeStartInteger
查询开始时间,根据上传时间查询,秒级时间戳,不得晚查询结束时间
uploadTimeEndInteger
查询结束时间,根据上传时间查询,秒级时间戳,不得早于查询开始时间
pageIndexString
取素材列表第几页,从1开始取值,默认为1
pageSizeString
平均每页素材数量,取值范围1-50,默认为10

返回参数

Body 参数

参数名称描述
codeInteger
结果状态码,200为成功
messageString
返回消息
dataObject
返回数据
totalInteger
符合查询条件的素材总个数
materialListList
素材列表
idString
素材ID
nameString
素材名称
suffixString
文件后缀
fileSizeLong
文件大小(单位为bit)
urlString
文件url
createUserString
创建用户
createTimeInteger
创建时间

错误码

错误代码(code)描述(message)HTTP状态码语义
1301User has no permission200用户无权限
1004The parameter is incorrect. Please ensure that all required fields are filled in200参数错误,请确保所有必填项都已经填写
1000The material id does not exist200素材id不存在
1407The start time cannot be later than the end time200开始时间不能大于结束时间

示例

JSON
JSON
请求示例
复制代码 复制成功
#!/bin/bash
username='example_username'
apiKey='example_apiKey'
date=`env LANG="en_US.UTF-8" date -u "+%a, %d %b %Y %H:%M:%S GMT"`
password=`echo -en "$date" | openssl dgst -sha1 -hmac $apiKey -binary | openssl enc -base64`
curl -i --url "https://open.chinanetcenter.com/vod/material/getMaterialList" \
-X "POST" \
-u "$username:$password" \
-H "Date: $date" \
-H "x-cnc-auth-method: BASIC" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
	"materialId":"XXXXXXXXXXX",
	"materialName":"name",
	"suffix":"jpg",
	"createUser":"testUser",
	"publishDomain":"xxx.com",
	"uploadTimeStart":1669950908,
	"uploadTimeEnd":1669976108,
	"pageIndex":1,
	"pageSize":10
}'
返回示例
复制代码 复制成功
{
    "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": "操作成功"
}
本篇文档内容对您是否有帮助?
有帮助
我要反馈
提交成功!非常感谢您的反馈,我们会继续努力做到更好!