跳转到内容
Cheeli 文档
返回官网

素材中心--素材搜索接口

一、请求参数

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/searchmaterial

公共参数

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

业务参数

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

二、请求示例代码

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);
    }

三、返回结果

{
    "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