淘宝开放平台

登录
文档中心 > API类目 > 店铺API

店铺API

taobao.sellercats.list.get (获取前台展示的店铺内卖家自定义商品类目)

此API获取当前卖家店铺在淘宝前端被展示的浏览导航类目（面向买家）

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述

响应参数

名称 类型 示例值 描述
seller_cats SellerCat [] 卖家自定义类目
  • └ cid
  • Number
  • 12345
  • 卖家自定义类目编号
  • └ parent_cid
  • Number
  • 12
  • 父类目编号，值等于0：表示此类目为店铺下的一级类目，值不等于0：表示此类目有父类目
  • └ name
  • String
  • 自定义类型名称
  • 卖家自定义类目名称
  • └ pic_url
  • String
  • xva1sdfxxx.jpg
  • 链接图片地址
  • └ sort_order
  • Number
  • 1
  • 该类目在页面上的排序位置
  • └ type
  • String
  • manual_type
  • 店铺类目类型：可选值：manual_type：手动分类，new_type：新品上价， tree_type：二三级类目树 ，property_type：属性叶子类目树， brand_type：品牌推广

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
1
2
3
4
5
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
SellercatsListGetRequest req = new SellercatsListGetRequest();
req.setFields("cid,name");
SellercatsListGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
7
8
9
10
11
12
<sellercats_list_get_response>
    <seller_cats>
        <seller_cat>
            <cid>12345</cid>
            <parent_cid>12</parent_cid>
            <name>自定义类型名称</name>
            <pic_url>xva1sdfxxx.jpg</pic_url>
            <sort_order>1</sort_order>
            <type>manual_type</type>
        </seller_cat>
    </seller_cats>
</sellercats_list_get_response>

异常示例

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

错误码解释

错误码 错误描述 解决方案
isv.invalid-parameter:uid 参数：uid无效，格式不对、非法值、越界等 用户对应的店铺已过期，或者不存在，正常错误提醒，不要重试
isv.user-not-exist:invalid-nick 根据用户昵称:***查询不到对应的用户信息 发生错误不要重试,清除本地数据库该用户资料，或者使用其他接口（如：taobao.item.get）来更新用户资料
isv.shop-not-exist 根据用户找不到店铺 用户未开店，不要重试

API工具

API测试工具 错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问
返回
顶部