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

taobao.universalbp.stdcategory.findlist (人群相关类目查询)

入参商品信息,出参商品所属类别

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
top_service_context TopServiceContext 必须 topServiceContext
  • └ biz_code
  • String
  • 必须
  • xxxxx
  • api业务线编码
std_category_query_v_o StdCategoryQueryVo 必须 stdCategoryQueryVO
  • └ material_id_list
  • Number []
  • 可选
  • [714894818852, 714901906337, 715106275342, 714813770503, 714707465203]
  • 宝贝id集合
  • └ promotion_type
  • String
  • 可选
  • item
  • 推广主体类型,item:商品,item_private_mini:独享橱窗,shop:店铺,content:内容,short_video:短视频,user_define:自定义;
  • └ parent_cat_level
  • Number
  • 可选
  • 0
  • 父级类目级别

响应参数

名称 类型 示例值 描述
result TopResult 结果体
  • info
  • TopInfo
  • 请求系统信息
  • └ ok
  • Boolean
  • true
  • 是否成功
  • └ message
  • String
  • 参数错误
  • 错误信息
  • └ error_code
  • String
  • xxxxx
  • 错误编码
  • std_category_v_o_top_bulk_data
  • TopBulkData
  • 结果集
  • std_category_v_o_list
  • StdCategoryVo []
  • 批量结果集
  • └ cat_id
  • Number
  • 35
  • 类目id
  • └ cat_name
  • String
  • 童装/婴儿装/亲子装
  • 类目名称
  • └ cat_level
  • Number
  • 1
  • 类目级别,一级类目、二级目录
  • └ count
  • Number
  • 1
  • 数量

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
UniversalbpStdcategoryFindlistRequest req = new UniversalbpStdcategoryFindlistRequest();
UniversalbpStdcategoryFindlistRequest.TopServiceContext obj1 = new UniversalbpStdcategoryFindlistRequest.TopServiceContext();
obj1.setBizCode("xxxxx");
req.setTopServiceContext(obj1);
UniversalbpStdcategoryFindlistRequest.StdCategoryQueryVo obj2 = new UniversalbpStdcategoryFindlistRequest.StdCategoryQueryVo();
obj2.setMaterialIdList(new Long[] { 714894818852, 714901906337, 715106275342, 714813770503, 714707465203 };
);
obj2.setPromotionType("item");
obj2.setParentCatLevel(0L);
req.setStdCategoryQueryVO(obj2);
UniversalbpStdcategoryFindlistResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<universalbp_stdcategory_findlist_response>
    <result>
        <info>
            <ok>true</ok>
            <message>参数错误</message>
            <error_code>xxxxx</error_code>
        </info>
        <std_category_v_o_top_bulk_data>
            <std_category_v_o_list>
                <std_category_vo>
                    <cat_id>35</cat_id>
                    <cat_name>童装/婴儿装/亲子装</cat_name>
                    <cat_level>1</cat_level>
                </std_category_vo>
            </std_category_v_o_list>
            <count>1</count>
        </std_category_v_o_top_bulk_data>
    </result>
</universalbp_stdcategory_findlist_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

返回
顶部