图片空间上传接口
1.请求参数:
请求参数
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
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 | 图片的修改时间 |
文档更新时间: 2025-01-09 19:34 作者:admin