素材中心–素材搜索接口
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
公共参数
参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
---|---|---|---|---|
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-12-11 20:08 作者:JSL