taobao.itemcats.get (获取后台供卖家发布商品的标准商品类目)

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

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
cids Number [] 可选 18957,19562
  • 最大列表长度:999
  • 商品所属类目ID列表,用半角逗号(,)分隔 例如:(18957,19562,) (cids、parent_cid至少传一个)
    datetime Date 可选 2000-01-01 00:00:00 无效字段,暂无法使用。时间戳(格式:yyyy-MM-dd HH:mm:ss)如果该字段没有传,则取当前所有的类目信息,如果传了parent_cid或者cids,则忽略datetime,如果该字段传了,那么可以查询到该时间到现在为止的增量变化
    fields String [] 可选 cid,parent_cid,name,is_parent
  • 默认值:cid,parent_cid,name,is_parent
  • 最大列表长度:999
  • 需要返回的字段列表,见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 可选 50011999 父商品类目 id,0表示根节点, 传输该参数返回所有子类目。 (cids、parent_cid至少传一个)

    响应参数

    名称 类型 示例值 描述
    last_modified Date 2015-01-01 00:00:00 最近修改时间(如果取增量,会返回该字段)。
    item_cats ItemCat [] 商品类目结构
    • └ cid
    • Number
    • 50011999
    • 商品所属类目ID
    • features
    • Feature []
    • Feature对象列表 目前已有的属性: 若Attr_key为 udsaleprop,attr_value为1 则允许卖家在改类目新增自定义销售属性,不然为不允许
    • └ attr_key
    • String
    • 1234
    • 属性键
    • └ attr_value
    • String
    • 2342
    • 属性值
    • └ is_parent
    • Boolean
    • true
    • 该类目是否为父类目(即:该类目是否还有子类目)
    • └ name
    • String
    • 单方精油
    • 类目名称
    • └ parent_cid
    • Number
    • 0
    • 父类目ID=0时,代表的是一级的类目
    • └ sort_order
    • Number
    • 1
    • 排列序号,表示同级类目的展现次序,如数值相等则按名称次序排列。取值范围:大于零的整数
    • └ status
    • String
    • normal
    • 状态。可选值:normal(正常),deleted(删除)
    • └ taosir_cat
    • Boolean
    • false
    • 是否度量衡类目

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    ItemcatsGetRequest req = new ItemcatsGetRequest();
    req.setCids("18957,19562");
    req.setDatetime(StringUtils.parseDateTime("2000-01-01 00:00:00"));
    req.setFields("cid,parent_cid,name,is_parent");
    req.setParentCid(50011999L);
    ItemcatsGetResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <itemcats_get_response>
        <last_modified>2015-01-01 00:00:00</last_modified>
        <item_cats>
            <item_cat>
                <cid>50011999</cid>
                <features>
                    <feature>
                        <attr_key>1234</attr_key>
                        <attr_value>2342</attr_value>
                    </feature>
                </features>
                <is_parent>true</is_parent>
                <name>单方精油</name>
                <parent_cid>0</parent_cid>
                <sort_order>1</sort_order>
                <status>normal</status>
                <taosir_cat>false</taosir_cat>
            </item_cat>
        </item_cats>
    </itemcats_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>

    错误码解释

    错误码 错误描述 解决方案
    isv.missing-parameter:parent_cid-or-cids-or-datetime 参数:parent_cid,cids,datetime三个必选其一 在前端做好校验,特殊可选参数至少要传入一个才可以
    isv.permission-api-package-limit 权限不足 请确认appkey是否有该API权限
    isv.permission-ip-whitelist-limit IP白名单限制 请在开发者后台添加发起请求的IP地址
    isp.top-remote-connection-timeout 服务端异常 一般由于请求数据过多,服务端响应超时,请稍后重试

    API工具

    如何获得此API

    FAQ

    返回
    顶部