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

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

1.请求参数:

请求URL:

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

参数名 类型 说明 示例
appid String 合作伙伴AppId uwkahf@jfs92
timestamp String 当前时间戳
tb_seller_nick String 淘宝卖家店铺登录账号,非店铺名称 kingdo
sign String 接口签名 如何计算生成见示例代码
cids number[] 商品所属类目ID列表,用半角逗号(,)分隔 例如:(18957,19562,) (cids、parent_cid至少传一个)
fields String[] 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_cid Number 父商品类目 id,0表示根节点, 传输该参数返回所有子类目。 (cids、parent_cid至少传一个)
datetime datetime 无效字段,暂无法使用。时间戳(格式:yyyy-MM-dd HH:mm:ss)如果该字段没有传,则取当前所有的类目信息,如果传了parent_cid或者cids,则忽略datetime,如果该字段传了,那么可以查询到该时间到现在为止的增量变化

2. 请求示例代码(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);

    }

3. 返回结果如下:

返回结果,不同的参数结果会不同,由于受篇幅限制,下面的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会包含失败原因。

文档更新时间: 2023-05-18 15:55   作者:admin