图片空间上传接口

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, String> data = new HashMap<String, String>();  
        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", "item_lb_img1.jpg");   
        String base64ImageLogo = Utils.getBase64ImageFromBinary("/Users/demodata/item_lb_img1.jpg");  
        data.put("base64_image", base64ImageLogo);  
        // 非必填, 图片分类的父分类,一级分类的parent_id为0,二级分类的则为其父分类的picture_category_id  
//        data.put("parent_id", "0");  
        // 签名  
        data.put("sign", Utils.Sign(data, Config.AppSecret));  
        // 调用服务API  
        doHttpRequest(Config.TaoBaoPictureUpload, data);  

    }

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 图片的修改时间
文档更新时间: 2023-04-24 00:19   作者:admin