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

批量上传图片到素材中心

一、请求参数

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

公共参数

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

业务参数

参数名称参数类型是否必须示例值参数描述
+materialsList是-素材信息；一次上传的数量限制50张图片且单个图片最大不能超过10M；
- request_idString是1234567890该参数仅有2个作用：（1）一次请求中素材的唯一标示；（2）接口防并发，规则是：不同请求所有request_id排序之后拼接起来，若相同视为同一次请求
-folder_idString是0文件夹id，0为素材中心根目录。若想创建文件夹，请参考：创建文件夹文档
-nameString是这是一个图片素材名称，长度限制为50个字符
-urlString否http://xxx/origin图片url，必须是公网可访问地址；如果是二进制上传，请使用file_uri字段。url和file_uri二选一，不能同时为空
-file_uriString否tos-cn-i-7veqoeduo3/9e1df78…二进制文件对应的uri，获取方式请参考：二进制上传素材指南
-material_typeString是photo素材类型，请传固定值：photo
need_distinctBool否false是否需要去重（true/false），默认为false。去重是指：存在已经审核通过且内容相同的图片，直接返回已存在的图片地址。

二、请求示例代码

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

三、返回结果

{
  "code": 0,
  "message": "ok",
  "data": "success"
}

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