taobao.shopcats.list.get (获取前台展示的店铺类目)

获取淘宝面向买家的浏览导航类目(跟后台卖家商品管理的类目有差异)

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
fields String [] 可选 cid,parent_cid,name,is_parent
  • 默认值:cid,parent_cid,name,is_parent
  • 最大列表长度:20
  • 需要返回的字段列表,见ShopCat,默认返回:cid,parent_cid,name,is_parent

    响应参数

    名称 类型 示例值 描述
    shop_cats ShopCat [] 店铺类目列表信息
    • └ cid
    • Number
    • 12345678
    • 类目编号
    • └ parent_cid
    • Number
    • 123456
    • 父类目编号,注:此类目指前台类目,值等于0:表示此类目为一级类目,值不等于0:表示此类目有父类目
    • └ name
    • String
    • 名称
    • 类目名称
    • └ is_parent
    • Boolean
    • true
    • 该类目是否为父类目。即:该类目是否还有子类目

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    ShopcatsListGetRequest req = new ShopcatsListGetRequest();
    req.setFields("cid,parent_cid,name,is_parent");
    ShopcatsListGetResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <shopcats_list_get_response>
        <shop_cats>
            <shop_cat>
                <cid>12345678</cid>
                <parent_cid>123456</parent_cid>
                <name>名称</name>
                <is_parent>true</is_parent>
            </shop_cat>
        </shop_cats>
    </shopcats_list_get_response>

    异常示例

    • XML示例
    • JSON示例
    <error_response>
        <code>50</code>
        <msg>Remote service error</msg>
        <sub_code>isv.invalid-parameter</sub_code>
        <sub_msg>非法参数</sub_msg>
    </error_response>

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部