文档中心 > API类目 > 直通车API

taobao.simba.insight.catsinfo.get (类目信息获取)

获取类目信息,此接口既提供所有顶级类目的查询,又提供给定类目id自身信息和子类目信息的查询,所以可以根据此接口逐层获取所有的类目信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
type Number 必须 0 表示请求的类型:0表示请求所有顶级类目的信息,这时可以忽略第二个参数,1表示获取给定的类目id的详细信息,2表示获取给定类目id的所有子类目的详细信息
category_id_list String [] 可选 50014579
  • 最大列表长度:20
  • 需要查询的类目id

    响应参数

    名称 类型 示例值 描述
    category_info_list InsightCategoryInfoDTO [] 类目详细信息
    • └ cat_id
    • Number
    • 50014566
    • 类目Id
    • └ cat_path_name
    • String
    • 汽车,用品,配件,改装汽车零配件制动系统刹车片
    • 表示类目的所有父级类目的名称,不同层级之间用(ascii码为2的字符)分隔开
    • └ cat_path_id
    • String
    • 26 50018708 50018787 50014563
    • 表示该类目的所有父级类目,按层级顺序排列,层级越高的在前面,不同的层级之间用空格分隔
    • └ parent_cat_id
    • Number
    • 50014511
    • 父类目Id
    • └ last_sync_time
    • Date
    • 2000-01-01 00:00:00
    • 表示类目信息上次同步的时间
    • └ cat_level
    • Number
    • 1
    • 类目的级别
    • └ cat_name
    • String
    • 应急灯/维修灯
    • 类目名称

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    SimbaInsightCatsinfoGetRequest req = new SimbaInsightCatsinfoGetRequest();
    req.setType(0L);
    req.setCategoryIdList("50014579");
    SimbaInsightCatsinfoGetResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <simba_insight_catsinfo_get_response>
        <category_info_list>
            <insight_category_info_d_t_o>
                <cat_id>50014566</cat_id>
                <cat_path_name>汽车,用品,配件,改装汽车零配件制动系统刹车片</cat_path_name>
                <cat_path_id>26 50018708 50018787 50014563</cat_path_id>
                <parent_cat_id>50014511</parent_cat_id>
                <last_sync_time>2000-01-01 00:00:00</last_sync_time>
                <cat_level>1</cat_level>
                <cat_name>应急灯/维修灯</cat_name>
            </insight_category_info_d_t_o>
        </category_info_list>
    </simba_insight_catsinfo_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

    返回
    顶部