单个图片上传

素材中心同步创建图片素材接口
1、如需上传多个素材,请使用批量上传图片接口:【/material/batch/upload/image/sync】且单个图片最大不能超过10M;支持的格式有:png/jpg;
3、接口上传成功,素材中心会对素材进行异步审核,审核时效:非风险图片99%在4s内完成审核,风险图片我们会在24h内审核完成;对于审核失败的素材,素材中心会在一定时间内将其删除。
4、上传时需要关注文件夹属性,只有0(文件夹)和1(图片文件夹)才可以上传图片。文件夹属性可通过【/material/getFolderInfo】和【/material/searchFolder】查看;
5、2022年11月-素材接口字段变更公告:https://op.jinritemai.com/docs/notice-docs/5/2668 响应参数ByteUrl字段废弃;只有AuditStatus=3时ByteUrl才会返回;

请求URL:

POST https://kf.fw199.com/gateway/dd/material/upload/image/sync

公共参数

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

业务参数

参数名称 参数类型 是否必须 示例值 参数描述
folder_id String 0 文件夹id,0为根目录
url String http://xxx.xxx 图片url,必须是公网可访问。url和file_uri二选一,不能同时为空,如果2者都不为空取url
material_name String 图片名称.jpg 图片名称,开发者自定义,不得超过50个字符。
file_uri - tos-cn-i-7veqoeduo3/9e1df78… 二进制文件对应的uri,获取方式请参考:二进制上传素材指南
need_distinct Bool false 是否需要去重(true/false),默认为false。去重是指:存在已经审核通过且内容相同的图片,直接返回已存在的图片地址。

2. 请求示例代码(Java)

请求示例代码

    @Test
    public void  DDMaterialUploadimageSync() 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("folder_id","73691281073984637961425" );
//        data.put("url","https://www.cheeli.com.cn/wp-content/themes/stratusx-child/img/product/productA1.jpg" );

//        Path path = Paths.get("/Users/bytedance/Desktop/123.jpeg");//请填写您的图片路径
//        byte[] bytes = Files.readAllBytes(path);
        data.put("file_uri","tos-cn-i-7veqoeduo3/e4709f4a0fa94bfbb345701aae83f3e1.jpg");
        data.put("material_name","test3.jpg" );
        data.put("need_distinct","false" );
        data.put("sign", Sign(data,Config.AppSecret));
        // 调用服务API
        String resp = doHttpRequest(Config.DDMaterialUploadImageSync, data);
        System.out.println(resp);
    }

3. 返回结果如下:


{
    "code": 0,
    "message": "ok",
    "data": {
    "audit_status": "1",
    "byte_url": "https://xxx.xx",
    "folder_id": "0",
    "is_new": "true",
    "material_id": "7000254886243811628"
  }
}

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

文档更新时间: 2024-05-22 10:49   作者:JSL