上传图片

上传商品图片

上传商品主图或商品详情图

一、请求参数

请求URL:

POST https://kf.fw199.com/gateway/ks/item/upload/file

公共参数

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

业务参数

参数名称	参数类型	是否必须	示例值	参数描述
img_url	String	是		图片来源
upload_type	int	是	1	1（商品主图），长宽比为1:1的图片、 2（商品详情图）、 3（sku图片），长宽比为1:1的图片、 4（类目属性图片）、 5（商品白底图，请上传格式为png/jpeg/jpg的图片，长宽比为1:1的图片，像素480*480px以上的图片，大小小于2M）、 6（商品透明图，请上传格式为png的图片，长宽比为1:1的图片，像素480*480px以上的图片，大小小于2M）、 9（标品图片）
from	int	是	0	图片上传方式，0： 本地文件上传，1：通过url上传，将img_url图片直接上传到快手图片空间。
file	File	可选		当from为0时， 通过本地文件上传图片。必填。

二、请求示例代码

Java

二（一）、通过url方式上传图片的示例代码

@Test
    public void  UploadimageSync() 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.KSSellerNick);
        // 通过url上传图片示例
        data.put("img_url","https://cbu01.alicdn.com/img/ibank/O1CN01iYAWn81J4b81Vjl8e_!!3482710975-0-cib.jpg" );
        data.put("upload_type", 1);
        data.put("from", 1); // 0: 本地上传, 1:通过url上传,  img_url即可要下载的图片地址
        data.put("sign", Sign(data,Config.AppSecret));
        String resp = doHttpRequest(Config.KSUploadFileUrl, data);
        System.out.println(resp);

    }

二（二）、通过本地文件方式上传图片的示例代码

@Test
    public void  UploadimageSync() 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.KSSellerNick);

        // 本地上传图片示例
        data.put("img_url","https://cbu01.alicdn.com/img/ibank/O1CN01LezKDm1J4b8493zZb_!!3482710975-0-cib.jpg" );
        data.put("upload_type", 1);
        data.put("from", 0); // 0: 本地上传, 1:通过url上传,  img_url即可要下载的图片地址
        String   filePath = "/Users/miller/working/demodata/img-validate/ITEM_IMAGE-2589256601-14be4b6ec86e46bc95c3bef22ae34b99.jpg";
        data.put("sign", Sign(data,Config.AppSecret));
        String resp = doHttpRequest(Config.KSUploadFileUrl, data,filePath);
        System.out.println(resp);

    }

三、返回结果

{
  "code": 0,
  "message": "ok",
  "data": {
    "originImgUrl": "https://cbu01.alicdn.com/img/ibank/O1CN01iYAWn81J4b81Vjl8e_!!3482710975-0-cib.jpg",
    "kwaiImgUrl": "https://p2-ec.ecukwai.com/bs2/image-kwaishop-product/ITEM_IMAGE-2589256601-4dc5ea314dea401b90e2372bfc64d743.jpg"
  },
  "trace_id": ""
}

四、返回字段说明

返回 code为0时，说明成功，非0时，说明失败。message中会有失败原因。

字段	类型	示例	说明
originImgUrl	String		原始图片url
kwaiImgUrl	String		快手图片url