跳转到内容
Cheeli 文档
返回官网

获取卖家发布商品标准类目

获取后台供卖家发布商品的标准商品类目。

一、请求参数

请求URL:

POST https://kf.fw199.com/gateway/taobao/itemcats/get

参数名类型说明示例
appidString合作伙伴AppIduwkahf@jfs92
timestampString当前时间戳
tb_seller_nickString淘宝卖家店铺登录账号，非店铺名称kingdo
signString接口签名如何计算生成见示例代码
cidsnumber[]商品所属类目ID列表，用半角逗号(,)分隔 例如:(18957,19562,) (cids、parent_cid至少传一个)
fieldsString[]cid,parent_cid,name,is_parent 需要返回的字段列表，见ItemCat，默认返回：cid,parent_cid,name,is_parent；增量类目信息,根据fields传入的参数返回相应的结果。 features字段： 1、如果存在attr_key=freeze表示该类目被冻结了，attr_value=0,5，value可能存在2个值（也可能只有1个），用逗号分割，0表示禁编辑，5表示禁止发布
parent_cidNumber父商品类目 id，0表示根节点, 传输该参数返回所有子类目。 (cids、parent_cid至少传一个)
datetimedatetime无效字段，暂无法使用。时间戳（格式:yyyy-MM-dd HH:mm:ss）如果该字段没有传，则取当前所有的类目信息,如果传了parent_cid或者cids，则忽略datetime，如果该字段传了，那么可以查询到该时间到现在为止的增量变化

二、请求示例代码

Java

@Test
    public void  getItemCats() 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());
        // 如果 (cids、parent_cid )都没有传，可以传日期值


        // 如果使用默认值，则不要传入参数cids
        //  data.put("cids", "");
        // 如果使用默认值，则不要传入参数fields
        // data.put("fields", "cid,parent_cid,name,is_parent");
        // 如果使用默认值， 则不要传入参数parent_cid
         data.put("parent_cid", "50011740");
        // 签名
        data.put("sign", Utils.Sign(data,Config.AppSecret));
        // 调用服务API
        doHttpRequest(Config.TaoBaoItemCatGet ,data);


    }

三、返回结果

返回结果，不同的参数结果会不同，由于受篇幅限制，下面的json只显示部分类目数据。

{
    "code": 0,
    "message": "ok",
    "data": {
        "item_cats": {
            "item_cat": [{
                "cid": 0,
                "is_parent": true,
                "parent_cid": -1
            }, {
                "cint": false,
                "name": "其他",
                "parent_cid": 201212264
            }, {
                "cid": 201212266,  //  类目id
                "is_parent": false, // 是否为父类目属性
                "name": "擦银布", // 类目名称
                "parent_cid": 201212264   // 父类目ID=0时，代表的是一级的类目
            }, {
                "cid": 201212267,
                "is_parent": false,
                "name": "洗金水",
                "parent_cid": 201212264
            },  {
                "cid": 201212271,
                "is_parent": false,
                "name": "扣",
                "parent_cid": 201212268
            },  {
                "cid": 201533501,
                "is_parent": false,
                "name": "字帖/练字帖",
                "parent_cid": 33
            }]
        },
        "last_modified": "2021-01-05 12:30:28",
        "request_id": "4xnwviuv5mmr"
    }
}

说明： code为0表示成功，非0为失败，message会包含失败原因。