批量上传图片到素材中心
1、一次上传的数量限制50张图片且单个图片最大不能超过10M;
2、接口上传成功,素材中心会对素材进行异步审核,审核时效:非风险图片99%在4s内完成审核,风险图片我们会在24h内审核完成;对于审核失败的素材,素材中心会在一定时间内将其删除;
3、上传时需要关注文件夹属性为0-文件夹和1-图片文件夹才可以上传图片,文件夹属性可通过【/material/getFolderInfo】和【/material/searchFolder】查看。
请求URL:
POST https://kf.fw199.com/gateway/dd/material/batch/upload/image/sync
公共参数
参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
---|---|---|---|---|
appid | String | 是 | 合作伙伴AppId | |
timestamp | String | 是 | 1657525936 | 当前Unix时间戳,秒 |
seller_nick | String | 是 | 38173182 | 抖店的账号,对应蜂巢授权返回doudianseller字段 |
sign | String | 是 |
业务参数
参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
---|---|---|---|---|
+materials | List | 是 | - | 素材信息;一次上传的数量限制50张图片且单个图片最大不能超过10M; |
- request_id | String | 是 | 1234567890 | 该参数仅有2个作用:(1)一次请求中素材的唯一标示;(2)接口防并发,规则是:不同请求所有request_id排序之后拼接起来,若相同视为同一次请求 |
-folder_id | String | 是 | 0 | 文件夹id,0为素材中心根目录。若想创建文件夹,请参考:创建文件夹文档 |
-name | String | 是 | 这是一个图片 | 素材名称,长度限制为50个字符 |
-url | String | 否 | http://xxx/origin | 图片url,必须是公网可访问地址;如果是二进制上传,请使用file_uri字段。url和file_uri二选一,不能同时为空 |
-file_uri | String | 否 | tos-cn-i-7veqoeduo3/9e1df78… | 二进制文件对应的uri,获取方式请参考:二进制上传素材指南 |
-material_type | String | 是 | photo | 素材类型,请传固定值:photo |
need_distinct | Bool | 否 | false | 是否需要去重(true/false),默认为false。去重是指:存在已经审核通过且内容相同的图片,直接返回已存在的图片地址。 |
2. 请求示例代码(Java)
请求示例代码
@Test
public void DDMaterialBatchuploadImagesync() 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("materials","[\n" +
" {\n" +
" \"request_id\": \"1234567890\",\n" +
" \"folder_id\": \"73691281073984637961425\",\n" +
" \"name\": \"测试1\",\n" +
// " \"url\": \"https://www.cheeli.com.cn/wp-content/themes/stratusx-child/img/product/productA2.jpg\",\n" +
" \"file_uri\": \"tos-cn-i-7veqoeduo3/c52f2f641ff3473bb0abb4891ee0f908.jpg\",\n" +
" \"material_type\": \"photo\"\n" +
" },\n" +
" {\n" +
" \"request_id\": \"1234567891\",\n" +
" \"folder_id\": \"73691281073984637961425\",\n" +
" \"name\": \"测试2\",\n" +
// " \"url\": \"https://www.cheeli.com.cn/wp-content/themes/stratusx-child/img/product/productA2.jpg\",\n" +
" \"file_uri\": \"tos-cn-i-7veqoeduo3/6b56ed5b357748c1ac164109eec6292c.jpg\",\n" +
" \"material_type\": \"photo\"\n" +
" }\n" +
" ]" );
data.put("need_distinct","false" );
data.put("sign", Sign(data,Config.AppSecret));
// 调用服务API
String resp = doHttpRequest(Config.DDMaterialBatchUploadImageSync, data);
System.out.println(resp);
}
3. 返回结果如下:
{
"code": 0,
"message": "ok",
"data": "success"
}
说明: code为0表示成功,非0为失败,message会包含失败原因。返回字段说明见文档
https://op.jinritemai.com/docs/api-docs/69/1616
文档更新时间: 2024-05-22 13:51 作者:JSL