图片空间-新增图片分类信息

新增图片分类信息

同一卖家最多添加500个图片分类，图片分类名称长度最大为20个字符。

一、请求参数

请求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

二、请求示例代码

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);

    }

三、返回结果

{
  "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