淘宝开放平台

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

类目API

taobao.item.catprops.modification.get (查询商品类目属性变更)

查询商品类目属性变更信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
category_id Number 可选 201552112 类目Id（与商品Id二选一即可）
item_id String 可选 100404974555 商品Id（与类目Id二选一即可。若同时传入商品Id和类目Id，则优先使用商品Id。若填写商品Id，则起始时间设为该商品最近修改时间）
start_time String 可选 20210420 起始请求时间（建议传入，默认为90天内）

响应参数

名称 类型 示例值 描述
results PropsModificationResult [] 返回结果
  • └ property_id
  • Number
  • 250428190
  • 类目属性Id
  • └ required
  • Number
  • 1
  • 是否必填，0-否，1-是
  • └ multi_select
  • Number
  • 1
  • 是否多选，0-否，1-是
  • └ type
  • Number
  • 1
  • 变更类型: 删除(1), 修改(2), 新增(3)
  • └ ds
  • String
  • 20210420
  • 变更日期
  • └ property_name
  • String
  • 笔头类型
  • 属性名称

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
1
2
3
4
5
6
7
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
ItemCatpropsModificationGetRequest req = new ItemCatpropsModificationGetRequest();
req.setCategoryId(201552112L);
req.setItemId("100404974555");
req.setStartTime("20210420");
ItemCatpropsModificationGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
7
8
9
10
11
12
<item_catprops_modification_get_response>
    <results>
        <props_modification_result>
            <property_id>250428190</property_id>
            <required>1</required>
            <multi_select>1</multi_select>
            <type>1</type>
            <ds>20210420</ds>
            <property_name>笔头类型</property_name>
        </props_modification_result>
    </results>
</item_catprops_modification_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.item.invalid-categoryId 无效的类目ID 请输入有效的类目ID
isv.item.missing-parameter 缺少必要参数 请按照API说明补充参数
isv.item.un-match-itemId 商品信息与类目信息不匹配 请传入匹配的商品ID和类目Id

API工具

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

如何获得此API

FAQ

我要提问
返回
顶部