01 素材检索 - 服务端开放接口

注意

当前接口已进行升级，旧接口会陆续下线，请尽快升级到最新版。查看最新版>>素材检索

通过筛选条件查询素材信息

提示

当检索发生在素材组内时（即 collectionId 不为空时）：

若 keywordList、filterMap、assetIds 三个参数任意一个有值（且不为空），则会进行穿透子素材组搜索（能搜到儿子、孙子素材组里的素材）；
否则，则只检索当前素材组层级中的素材

素材筛选条件详解：

筛选条件获取：查询筛选模板元数据

2. 筛选条件设置：

筛选类型解释：

标签多选类型：

日期类型：

特殊类型：

素材状态筛选：

📌

素材状态解释:
可使用：素材正常，筛选值为"0"
已失效：素材已失效，筛选值为"1"
即将失效：素材即将失效，筛选值为"3"
未生效：素材未生效，筛选值为"2"
即将生效：素材即将生效，筛选值为"4"

创建人筛选：

素材大小筛选：

请求参数

Header 参数

Body 参数application/json

示例

{
    "token": "109217f4-d536-4fce-8329-39d48fd1f04d",
    "param": {
          "permalink":false,
          "collectionId": 17843,
        "sort": {
            "field": "default",
            "sort": "desc"
        },
        "pageNum": 1,
        "pageSize": 20
       
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

示例

{
    "code": "0",
    "message": "处理成功",
    "result": {
        "totalCount": 2,
        "list": [
            {
                "id": 87529,
                "assetId": 1300730,
                "name": "18742118d4053a917cfb1c6a4ddca867 (3)",
                "size": 24744,
                "createTime": 1642615200000,
                "createUserId": 100684,
                "createUserName": "杨琳",
                "extension": "JPEG",
                "thumbnailSrc": "https://tezign-assets.oss-cn-beijing.aliyuncs.com/t15/df559ad025e6c7af32ab0ce905379940.jpeg?Expires=1643226283&OSSAccessKeyId=LTAIiH7NZflLSZy3&Signature=bjL%2FbWeUlC%2Fa2lLa5%2FQNSe2a6dU%3D&response-content-disposition=inline&x-oss-process=image%2Fresize%2Cm_lfit%2Cw_300%2Ch_300",
                "downloadUrl": "https://tezign-assets.oss-cn-beijing.aliyuncs.com/t15/df559ad025e6c7af32ab0ce905379940.jpeg?Expires=1643226283&OSSAccessKeyId=LTAIiH7NZflLSZy3&Signature=8uSDt8x0V70woMczvYJU%2Bi1Tu70%3D&response-content-disposition=attachment%3Bfilename%3D%2218742118d4053a917cfb1c6a4ddca867%2520%283%29.jpeg%22&response-content-type=application%2Foctet-stream",
                "transformPreviewUrl": "https://assets-test-cdn.tezign.com/80159ff654b14124ba38c1d8ba82f581.png?Expires=2272274006399&OSSAccessKeyId=LTAI5tDubGKMRMroG8MuTLZo&Signature=FXSV9HerW%2FBe9VoALZ1J%2FANC%2B8k%3D&response-content-disposition=inline&yunCode=OSS&image_process=resize,s_300",
                "downloadPermission": true,
                "extend": {
                    "duration": null,
                    "width": 1920,
                    "height": 1080
                },
                "materialType": "common",
                "subAssetList": null
            },
            {
                "id": 17047,
                "assetId": 1535748,
                "name": "zh1",
                "size": 0,
                "createTime": 1654777559000,
                "createUserId": 1,
                "createUserName": "特赞项目顾问1234421",
                "extension": "res_group",
                "thumbnailSrc": "https://itg-tezign-files.tezign.com/t2/96228185c805e3afa34062eed762bc96.jpg?Expires=1662047999&OSSAccessKeyId=LTAI5tDubGKMRMroG8MuTLZo&Signature=Q0zAesouLq7WOZrD%2By2aEHxN9As%3D&response-content-disposition=inline&x-oss-process=image%2Fresize%2Cm_lfit%2Cw_300%2Ch_300",
                "downloadUrl": "",
                "transformPreviewUrl": "https://assets-test-cdn.tezign.com/80159ff654b14124ba38c1d8ba82f581.png?Expires=2272274006399&OSSAccessKeyId=LTAI5tDubGKMRMroG8MuTLZo&Signature=FXSV9HerW%2FBe9VoALZ1J%2FANC%2B8k%3D&response-content-disposition=inline&yunCode=OSS&image_process=resize,s_300",
                "downloadPermission": true,
                "extend": {},
                "materialType": "res-group",
                "subAssetList": [
                    {
                        "id": 1535611,
                        "name": "6cee2d979ca005ebbb66b0a7c547ade2.jpg",
                        "extension": "jpg",
                        "thumbnailSrc": "https://itg-tezign-files.tezign.com/t2/96228185c805e3afa34062eed762bc96.jpg?Expires=1662047999&OSSAccessKeyId=LTAI5tDubGKMRMroG8MuTLZo&Signature=Q0zAesouLq7WOZrD%2By2aEHxN9As%3D&response-content-disposition=inline&x-oss-process=image%2Fresize%2Cm_lfit%2Cw_300%2Ch_300",
                        "downloadUrl": "https://itg-tezign-files.tezign.com/t2/96228185c805e3afa34062eed762bc96.jpg?Expires=1662047999&OSSAccessKeyId=LTAI5tDubGKMRMroG8MuTLZo&Signature=bEn6O%2B2d8dadm7%2FCW429bpPGeDo%3D&response-content-disposition=attachment%3B%20filename%3D%226cee2d979ca005ebbb66b0a7c547ade2.jpg%22%3B%20filename%2A%3Dutf-8%27%276cee2d979ca005ebbb66b0a7c547ade2.jpg&response-content-type=application%2Foctet-stream",
                        "width": 224,
                        "height": 398,
                        "baseText": null
                    },
                    {
                        "id": 631622,
                        "name": "lzl.jpg",
                        "extension": "jpg",
                        "thumbnailSrc": "https://itg-tezign-files.tezign.com/9eaa958cfddcc2a677959bc81720ea7c.jpg?Expires=1662047999&OSSAccessKeyId=LTAI5tDubGKMRMroG8MuTLZo&Signature=bWHFawOwJTh9bYQj4wZVJYxabeI%3D&response-content-disposition=inline&x-oss-process=image%2Fresize%2Cm_lfit%2Cw_300%2Ch_300",
                        "downloadUrl": "https://itg-tezign-files.tezign.com/9eaa958cfddcc2a677959bc81720ea7c.jpg?Expires=1662047999&OSSAccessKeyId=LTAI5tDubGKMRMroG8MuTLZo&Signature=NiFDXxGu53fhupv%2BOI5Kvd%2FFNZ8%3D&response-content-disposition=attachment%3B%20filename%3D%22lzl.jpg%22%3B%20filename%2A%3Dutf-8%27%27lzl.jpg&response-content-type=application%2Foctet-stream",
                        "width": 500,
                        "height": 517,
                        "baseText": null
                    },
                    {
                        "id": 1535747,
                        "name": "3406abcbf420f400c80dd7e78517a395.mp4",
                        "extension": "mp4",
                        "thumbnailSrc": "https://itg-tezign-files.tezign.com/t2/49b6db13847962552e6fd3b9223aa4ee.mp4?Expires=1662047999&OSSAccessKeyId=LTAI5tDubGKMRMroG8MuTLZo&Signature=pZMiRpJBzz1T70pJyxBwN72IuiU%3D&response-content-disposition=inline&x-oss-process=video%2Fsnapshot%2Cm_fast%2Cw_300%2Ct_1000",
                        "downloadUrl": "https://itg-tezign-files.tezign.com/t2/49b6db13847962552e6fd3b9223aa4ee.mp4?Expires=1662047999&OSSAccessKeyId=LTAI5tDubGKMRMroG8MuTLZo&Signature=xAiz0C71k37db8l74SfssyhHHUM%3D&response-content-disposition=attachment%3B%20filename%3D%223406abcbf420f400c80dd7e78517a395.mp4%22%3B%20filename%2A%3Dutf-8%27%273406abcbf420f400c80dd7e78517a395.mp4&response-content-type=application%2Foctet-stream",
                        "width": null,
                        "height": null,
                        "duration": 3000,
                        "baseText": null
                    },
                    {
                        "id": 1535746,
                        "name": "d2a460df08a4fb7a558f635b540d90cb",
                        "extension": "content_text",
                        "thumbnailSrc": null,
                        "downloadUrl": null,
                        "width": null,
                        "height": null,
                        "baseText": "gu"
                    }
                ]
            }
        ]
    }
}