素材中心–素材搜索接口

1、不会返回已经删除的素材;
2、请至少传入一个入参,如果没有任何搜索条件,即:除page_num、page_size、order_type之外的字段都为空,会返【查询失败,未上传任何查询参数】错误。
3、2022年11月-素材接口字段变更公告:https://op.jinritemai.com/docs/notice-docs/5/2668 响应参数ByteUrl字段废弃;当audit_status=3时才会返回byte_url;视频请使用vid字段

请求URL:

POST https://kf.fw199.com/gateway/dd/material/search/material

公共参数

参数名称 参数类型 是否必须 示例值 参数描述
appid String 合作伙伴AppId
timestamp String 1657525936 当前Unix时间戳,秒
seller_nick String 38173182 抖店的账号,对应蜂巢授权返回doudianseller字段
sign String

业务参数

参数名称 参数类型 是否必须 示例值 参数描述
material_id String 7000291764753940780 素材id;可使用【/material/batchUploadImageSync】【/material/uploadImageSync】【/material/searchMaterial】接口获取
material_name String 模糊匹配 文件名称,支持模糊匹配
material_type List photo 素材类型,空-不限;photo-图片;video-视频;
operate_status List [0,1,4] 素材状态,0-待下载;1-有效;4-回收站中;
audit_status List [1,2,3,4] 审核状态,1-待审核;2-审核中;3-通过;4-拒绝;注意:只有AuditStatus=3时ByteUrl才会返回;
create_time_start String 2012-08-12 12:00:12 搜索创建开始时间,格式:yyyy-MM-dd HH:mm:ss
create_time_end String 2022-11-12 12:00:12 搜索创建结束时间,格式:yyyy-MM-dd HH:mm:ss
folder_id String 6999834643465781548 文件夹id,0-素材中心;-1-回收站;
material_id_list List [7000291764753940780,…] 素材id列表
page_num Int32 1 第几页,1,2,……,默认值:1
page_size Int32 20 页大小,1,2,……,100,默认值:50
order_type Int32 1 排序方式,0-按照创建时间倒序;1-按照创建时间升序;6-按照素材大小降序;7-按照素材大小升序;

2. 请求示例代码(Java)

请求示例代码

    @Test
    public void  DDMaterialSearchMaterial() throws Exception {
        Map<String, Object> data = new HashMap<String, Object>();
        data.put("appid",  Config.AppId);
        Long timestamp = System.currentTimeMillis() / 1000;
        data.put("timestamp", timestamp.toString());
        data.put("seller_nick", Config.DDSellerNick);
//        data.put("material_id", "7000291764753940780");
//        data.put("material_name", "模糊匹配");
        //素材类型,空-不限; photo-图片;video-视频;
        data.put("material_type", "photo");
//        data.put("operate_status", "[0,1,4]");
//        data.put("audit_status", "[1,2,3,4]");
        data.put("create_time_start", "2024-05-16 12:00:12");
        data.put("create_time_end", "2024-05-18 12:00:12");
//        data.put("folder_id", "6999834643465781548");
//        data.put("material_id_list", "[7000291764753940780,7000291764753940780]");
        data.put("page_num", 1);
        data.put("page_size", 20);
        data.put("order_type", 1);
        data.put("sign", Sign(data,Config.AppSecret));
        // 调用服务API
        String resp = doHttpRequest(Config.DDMaterialSearchMaterial, data);
        System.out.println(resp);
    }

3. 返回结果如下:


{
    "code": 0,
    "message": "ok",
    "data": {
        "material_info_list": [{
            "audit_reject_desc": "",
            "audit_status": 3,
            "byte_url": "https://p3-aio.ecombdimg.com/obj/ecom-shop-material/ZfkBZpcR_m_b119029aeedea9aab2ff75d2d80b545d_sx_17382_www660-269",
            "create_time": "2024-05-16 14:50:37",
            "delete_time": "",
            "folder_id": "102",
            "material_id": "73694862939340966760425",
            "material_name": "a7f04cf35e66495b8f7054aa507fac31~tplv-f99onmpd77-i",
            "material_type": "photo",
            "operate_status": 1,
            "origin_url": "http://p1-iccv.byteimg.com/tos-cn-i-f99onmpd77/a7f04cf35e66495b8f7054aa507fac31~tplv-f99onmpd77-image.image",
            "photoInfo": {
                "format": "png",
                "height": 269,
                "width": 660
            },
            "size": 17408,
            "update_time": "2024-05-16 14:50:37"
        }],
        "total": 3
    }
}

说明: code为0表示成功,非0为失败,message会包含失败原因。返回字段说明见文档
https://op.jinritemai.com/docs/api-docs/69/1148

文档更新时间: 2024-05-22 09:26   作者:JSL