图片空间上传接口

1.请求参数:

POST https://kf.fw199.com/gateway/taobao/picture/upload

请求参数

名称 类型 必须 示例值 描述
picture_category_id Number true 123 图片分类ID,设置具体某个分类ID或设置0上传到默认分类,只能传入一个分类
base64_image string true 我是被上传的文件内容 图片base64编码,不能为空,允许png、jpg、gif图片格式,3M以内。
image_input_title String true Bule.jpg 包括后缀名的图片标题,不能为空,如Bule.jpg,有些卖家希望图片上传后取图片文件的默认名
title String false 图片名称 图片标题,如果为空,传的图片标题就取去掉后缀名的image_input_title,超过50字符长度会截取50字符,重名会在标题末尾加”(1)”;标题末尾已经有”(数字)”了,则数字加1
client_type String false client:computer 图片上传的来源,有电脑版本宝贝发布,手机版本宝贝发布client:computer电脑版本宝贝使用,client:phone手机版本宝贝使用。注意:当client:phone时,图片限制为宽度在480-620之间,长度不能超过960,否则会报错。

2. 请求示例代码(Java)

  @Test
    public void  TaoBaoPictureUpload() throws Exception {

        String tb_seller_nick = Config.TBSellerNick ;
        //业务参数
        Map<String, Object> data = new HashMap<String, Object>();
        data.put("appid",  Config.AppId);
        data.put("tb_seller_nick", tb_seller_nick);
        Long timestamp = System.currentTimeMillis() / 1000;
        data.put("timestamp", timestamp.toString());
        // 必填 图片分类名称,最大长度20字符,中文字符算2个字符,不能为空
        data.put("picture_category_id", "0");
        data.put("image_input_title", "pdd.jpg");
        // 添加一张商品图片到num_iid指定的商品中 传入的num_iid所对应的商品必须属于当前会话的用 ,  商品图片内容类型:JPG;最大:3M 。支持的文件类型:jpg,jpeg,png
        String filePath = "/Users/xxxx/demodata/good_image.png";
//        data.put("parent_id", "0");
        // 签名
        data.put("sign", Utils.SignObject(data,Config.AppSecret));
        // 调用服务API
        String rsp = Utils.doHttpRequest(Config.TaoBaoPictureUpload, data, filePath);
        System.out.println(rsp);

    }

3. 返回结果

{
  "code": 0,
  "message": "ok",
  "data": {
    "picture": {
      "client_type": "client:computer",
      "created": "2023-04-23 23:03:59",
      "deleted": "0",
      "modified": "2023-04-23 23:03:59",
      "picture_category_id": 0,
      "picture_id": 1317607669788062218,
      "picture_path": "https://img.alicdn.com/imgextra/i2/661153176/O1CN01q7fUl51ZKejurUuAU_!!661153176.jpg",
      "pixel": "616x792",
      "sizes": 60196,
      "status": "0",
      "title": "pdd"
    },
    "request_id": "15sqn09syuueu"
  },
  "trace_id": ""
}

4. 返回参数说明

名称 类型 必须 示例值 描述
picture_id Number 123 图片ID
picture_category_id Number 12 图片分类ID
picture_path String 返回的是绝对路径
title String title 图片标题
sizes Number 100 图片大小,bite单位
pixel String 450x150 图片相素,格式:长x宽,如450x150
status String unfroze 图片状态,unfroze代表没有被冻结,froze代表被冻结,pass代表排查通过
deleted String deleted 图片是否删除的标记
client_type String client:computer或者client:phone 图片上传的来源,有电脑版本宝贝发布,手机版本宝贝发布
created Date 2000-01-01 00:00:00 图片的创建时间
modified Date 2000-01-01 00:00:00 图片的修改时间
文档更新时间: 2026-05-11 16:55   作者:admin