新增图片分类信息
同一卖家最多添加500个图片分类,图片分类名称长度最大为20个字符。
1.请求参数
请求URL:
POST https://kf.fw199.com/gateway/taobao/picture/category/add
参数名 | 类型 | 说明 | 示例 |
---|---|---|---|
appid | String | 合作伙伴AppId | uwkahf@jfs92 |
timestamp | String | 当前时间戳 | |
tb_seller_nick | String | 淘宝卖家店铺登录账号,非店铺名称 | kingdo |
sign | String | 接口签名 | 如何计算生成见示例代码 |
参数名 | 类型 | 必须 | 示例 | 说明 |
---|---|---|---|---|
picture_category_name | String | true | abcdefg | 图片分类名称,最大长度20字符,中文字符算2个字符,不能为空 |
parent_id | Number | false | 0 | 图片分类的父分类,一级分类的parent_id为0,二级分类的则为其父分类的picture_category_id |
2. 请求示例代码(Java)
@Test
public void TaoBaoPictureCategoryAdd() 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_name", "abc");
// 非必填, 图片分类的父分类,一级分类的parent_id为0,二级分类的则为其父分类的picture_category_id
// data.put("parent_id", "0");
// 签名
data.put("sign", Utils.Sign(data,Config.AppSecret));
// 调用服务API
doHttpRequest(Config.TaoBaoPictureCategoryAdd ,data);
}
3. 返回结果如下:
{
"code": 0,
"message": "ok",
"data": {
"picture_category_id": 1317618347001286735,
"picture_category_name": "abc3",
"position": 0,
"type": "user-define",
"total": 0,
"created": "2025-01-09 19:27:36",
"modified": "2025-01-09 19:27:36",
"parent_id": 0
},
"trace_id": ""
}
说明: code为0表示成功, 如果失败,msg会包含失败原因。 返回的字段说明
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
picture_category_id | Number | 1234 | 图片分类ID |
picture_category_name | String | 名称 | 图片分类名 |
position | Number | 1 | 图片分类排序 |
type | String | sys-fixture | 图片分类型别,sys-fixture代表店铺装修分类(系统分类),sys-auction代表宝贝图片分类(系统分类),user-define代表用户自定义分类 |
total | Number | 100 | 分类下的图片数 |
created | Date | 2000-01-01 00:00:00 | 图片类目的创建时间 |
modified | Date | 2000-01-01 00:00:00 | 图片分类的修改时间 |
parent_id | Number | 0 | 一级分类的parent_id为0 二级分类的则为其父分类的picture_category_id |
文档更新时间: 2025-01-09 19:45 作者:admin