文档中心 > API类目 > 淘宝商品API

tmall.item.increment.update.schema.get (天猫增量更新商品规则获取)

增量方式修改天猫商品的规则获取的API。 1.接口返回支持增量修改的字段以及相应字段的规则。 2.如果入参xml_data指定了更新的字段,则只返回指定字段的规则(ISV如果功能性很强,如明确更新Title,请拼装好次字段以提升API整体性能); 3.ISV初次接入,开发阶段,此字段不填可以看到所有支持增量的字段;但是如果上线功能明确,请尽量遵守第2条 4.如果ISV对字段规则非常清晰,可以直接组装入参数据提交到tmall.item.schema.increment.update进行数据更新。但是最好不要写死,比如每天还是有对此接口功能的一次比对。 ---(感谢爱慕旗舰店提供API命名)

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
item_id Number 必须 2100529818899 需要编辑的商品ID
xml_data String 可选 <?xml version="1.0" encoding="UTF-8"?><itemParam><field id="update_fields" name="更新字段列表" type="multiCheck"><values><value>title</value><value>description</value></values></field></itemParam> 如果入参xml_data指定了更新的字段,则只返回指定字段的规则(ISV如果功能性很强,如明确更新Title,请拼装好此字段以提升API整体性能)

响应参数

名称 类型 示例值 描述
update_item_result String <itemRule><field id="update_fields" type="multiCheck"><options><option displayName="商品标题" value="title"/></options></field></itemRule> 返回增量更新商品的规则文档

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TmallItemIncrementUpdateSchemaGetRequest req = new TmallItemIncrementUpdateSchemaGetRequest();
req.setItemId(2100529818899L);
req.setXmlData("<?xml version=\"1.0\" encoding=\"UTF-8\"?><itemParam><field id=\"update_fields\" name=\"更新字段列表\" type=\"multiCheck\"><values><value>title</value><value>description</value></values></field></itemParam>");
TmallItemIncrementUpdateSchemaGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<tmall_item_increment_update_schema_get_response>
    <update_item_result>&lt;itemRule&gt;&lt;field id=&quot;update_fields&quot; type=&quot;multiCheck&quot;&gt;&lt;options&gt;&lt;option displayName=&quot;商品标题&quot; value=&quot;title&quot;/&gt;&lt;/options&gt;&lt;/field&gt;&lt;/itemRule&gt;</update_item_result>
</tmall_item_increment_update_schema_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.invalid-parameter:item_id 商品id不存在 请确认商品是否存在或者已删除,传人正确的商品id
isv.invalid-permission:item-deleted 商品已删除 换正确的商品id
isp.tmall_item_service_error 服务错误,稍后重试 服务错误,稍后重试
isv.parameter-parase-error:xml_data 入参数据无法被转换识别 参数格式错误,参考api文档说明入参
isv.invalid-permission:update_item 该商品不属于当前用户 获取当前用户的商品重试
isv.invalid-permission:publish_itemupdate_item C卖家没有调用天猫服务层接口发布或编辑商品的权限 带tmall 字样的schema接口,仅支持天猫商家;淘宝用户使用带taobao 字样的schema接口
isp.tmallitem-service-error:empty 系统异常 请稍后重试
isv.invalid-parameter:category-not-found 商品类目参数有问题 请检查商品类目
isv.invalid-parameter:cid 商品cid参数异常 请检查商品cid参数
isv.invalid-parameter:item-not-found 商品不存在 请检查商品id
isp.service-unavailable 系统错误 偶尔出现重试,频繁出现反馈平台
isv.invalid-parameter:empty 系统异常 请求稍后重试
isv.invalid-parameter:category-frozen 商品类目异常 请求检查商品类目是否正确
isv.parameter-parse-error:xml_data xml_data内容异常 请检查xml_data内容是否正确
isv.invalid-parameter:cid;isp.tmallitem-service-error:empty 系统繁忙,请稍后重试 系统繁忙,请稍后重试
isp.tmallitem-service-error:empty;isv.invalid-parameter:cid 系统繁忙,请稍后重试 系统繁忙,请稍后重试
isp.tmallitem-service-error:empty;isv.invalid-parameter:cid;isv.invalid-parameter:empty;isp.tmallitem-service-error:empty 系统繁忙,请稍后重试 系统繁忙,请稍后重试
isp.system-service-error:empty 系统繁忙,请稍后重试 系统繁忙,请稍后重试
isp.system-service-error:sell_points 参数sell_points格式不正确 请检查sell_points参数格式,修改后再提交
isv.invalid-parameter:cid;isp.tmallitem-service-error:empty;isp.tmallitem-service-error:empty 服务错误,稍后重试 服务错误,稍后重试
SYS_REQUEST_TOO_FAST 请求过快,请降低请求频率 按照限定阈值进行请求(单个店铺每分钟上限为2000次)

API工具

如何获得此API

FAQ

返回
顶部