批量上传图片到素材中心

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