图片空间-上传图片到图片空间
图片空间上传接口
一、请求参数
请求参数
| 名称 | 类型 | 必须 | 示例值 | 描述 |
|---|---|---|---|---|
| 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,否则会报错。 |
二、请求示例代码
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);
}三、返回结果
{ "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": ""}四、返回参数说明
| 名称 | 类型 | 必须 | 示例值 | 描述 |
|---|---|---|---|---|
| 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 | 图片的修改时间 |