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

单个图片上传

一、请求参数

素材中心同步创建图片素材接口 1、如需上传多个素材，请使用批量上传图片接口：【/material/batch/upload/image/sync】且单个图片最大不能超过10M；支持的格式有：png/jpg； 3、接口上传成功，素材中心会对素材进行异步审核，审核时效：非风险图片99%在4s内完成审核，风险图片我们会在24h内审核完成；对于审核失败的素材，素材中心会在一定时间内将其删除。 如果本接口没有返回图片上传后的byte_url， 可根据返回的material_id通过素材详情查询接口查具体的图片url。

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/uploadimagesync

公共参数

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

业务参数

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

二、请求示例代码

Java

二（一）、上传公网上的已存在的图片

即已经知道公网上图片的url，将公网的图片下载到店铺的素材中心里， 示例如下：

@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" );
        data.put("material_name","test3.jpg" );
        data.put("need_distinct","false" );
        data.put("sign", Sign(data,Config.AppSecret));
        // 调用服务API
        String filePath = "";  //  不是传本地文件，此处留空。
        String resp = doHttpRequest(Config.DDMaterialUploadimageSync, data,filePath);
        System.out.println(resp);
    }

返回结果

{
  "code": 0,
  "message": "ok",
  "data": {
    "material_info": {
      "material_id": "74484998751869176420425",
      "folder_id": "73691281073984637961425",
      "origin_url": "https://www.cheeli.com.cn/wp-content/themes/stratusx-child/img/product/productA1.jpg",
      "byte_url": "https://p3-aio.ecombdimg.com/obj/ecom-shop-material/jpeg_m_7b0c5176542b6228bd6cb9b26b0b6e02_sx_10411_www339-350",
      "materil_name": "test3.jpg",
      "material_type": "photo",
      "operate_status": 1,
      "audit_status": 3,
      "audit_reject_desc": "",
      "size": 11264,
      "photo_info": {
        "height": 350,
        "width": 339,
        "format": "jpeg"
      },
      "video_info": null,
      "create_time": "2024-12-15 13:03:40",
      "update_time": "2024-12-15 13:03:43",
      "delete_time": ""
    }
  },
  "trace_id": ""
}

二（二）、上传本地文件

从本地电脑上传文件到店铺的素材中心，示例如下：

@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" );


        data.put("material_name","test3.jpg" );
        data.put("need_distinct","false" );
        data.put("sign", Sign(data,Config.AppSecret));
        // 调用服务API
        // 本地文件路径
        String filePath = "/Users/fcdev/working/demodata/good_image.png";
        String resp = doHttpRequest(Config.DDMaterialUploadimageSync, data,filePath);
        System.out.println(resp);
    }

返回结果

{
  "code": 0,
  "message": "ok",
  "data": {
    "material_info": {
      "material_id": "74478856420227812350425",
      "folder_id": "73691281073984637961425",
      "origin_url": "",
      "byte_url": "https://p3-aio.ecombdimg.com/obj/ecom-shop-material/png_m_a31d40ba9613add7dcccfc6e37867f60_sx_598754_www616-792",
      "materil_name": "女上衣",
      "material_type": "photo",
      "operate_status": 1,
      "audit_status": 3,
      "audit_reject_desc": "",
      "size": 599040,
      "photo_info": { "height": 792, "width": 616, "format": "png" },
      "video_info": null,
      "create_time": "2024-12-13 21:20:08",
      "update_time": "2024-12-13 21:20:08",
      "delete_time": ""
    }
  },
  "trace_id": ""
}

说明： code为0表示成功，非0为失败，message会包含失败原因。　

三、返回字段参数说明

material_infoStruct - 素材详情

参数名称参数类型字段标签示例值参数描述
material_idString70072571115707435960250素材id；可使用【/material/batchUploadImageSync】【/material/uploadImageSync】【/material/searchMaterial】接口获取
folder_idString70072571115706780601250文件夹id
origin_urlString“”开发者上传时传入的公网可访问地址
byte_urlString“”图片url；当audit_status=3时获取byte_url；有值返回
materil_nameString名称素材名称
material_typeStringvideo素材类型，photo-图片；video-视频
operate_statusInt320素材状态，0-待下载；1-有效；4-在回收站中
audit_statusInt325审核状态，1-待审核；2-审核中；3-通过；4-拒绝；注意：只有AuditStatus=3时ByteUrl才会返回
audit_reject_descString文件大小超出限制审核失败的原因
sizeInt641234大小，单位为byte

photo_infoStruct - 图片信息

参数名称参数类型字段标签示例值参数描述
heightInt32255图片高度
widthInt32255图片宽度
formatStringjpg图片格式

video_infoStruct - 视频信息

参数名称参数类型字段标签示例值参数描述
formatStringmp3视频格式
durationDouble12视频时长，单位秒
vidString12345678vid，用于获取视频播放地址，接口文档见：https://op.jinritemai.com/docs/api-docs/69/2164
heightInt3232视频高度
widthInt3223视频宽度
video_cover_urlStringwww.xxxxxxx.com视频封面地址
create_timeString2021-09-12 12:23:23素材创建时间
update_timeString2021-09-12 12:23:23素材最近一次修改时间
delete_timeString0素材移动到回收站的时间，只有在回收站中，该字段才有意义