淘宝开放平台

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	示例值	更多限制	描述
item_id	Number	必须	2100529818899		需要编辑的商品ID
xml_data	String	必须	<itemParam> <field id="update_fields" name="更新字段列表" type="multiCheck"> <rules> <rule name="requiredRule" value="true"/> </rules> <values> <value>title</value> </values> </field> <field id="title" name="商品标题" type="input"> <rules> <rule name="valueTypeRule" value="text"/> <rule name="minLengthRule" value="1" exProperty="include" unit="byte"/> <rule name="maxLengthRule" value="120" exProperty="include" unit="byte"/> <rule name="requiredRule" value="true"/> </rules> <value>测试请不要拍</value> </field> </itemParam>		根据tmall.item.increment.update.schema.get生成的商品增量编辑规则入参数据。需要更新的字段，一定要在入参的XML重点update_fields字段中明确指明

名称	类型	示例值	描述
update_item_result	String	12345	返回商品发布结果
gmt_modified	Date	2015-11-11 00:00:00	商品更新操作成功时间

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TmallItemSchemaIncrementUpdateRequest req = new TmallItemSchemaIncrementUpdateRequest();
req.setItemId(2100529818899L);
req.setXmlData("<itemParam>   <field id=\"update_fields\" name=\"更新字段列表\" type=\"multiCheck\">     <rules>       <rule name=\"requiredRule\" value=\"true\"/>     </rules>     <values>       <value>title</value>     </values>   </field>   <field id=\"title\" name=\"商品标题\" type=\"input\">     <rules>       <rule name=\"valueTypeRule\" value=\"text\"/>       <rule name=\"minLengthRule\" value=\"1\" exProperty=\"include\" unit=\"byte\"/>       <rule name=\"maxLengthRule\" value=\"120\" exProperty=\"include\" unit=\"byte\"/>       <rule name=\"requiredRule\" value=\"true\"/>     </rules>     <value>测试请不要拍</value>   </field> </itemParam>");
TmallItemSchemaIncrementUpdateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
TmallItemSchemaIncrementUpdateRequest req = new TmallItemSchemaIncrementUpdateRequest();
req.ItemId = 2100529818899L;
req.XmlData = "<itemParam>   <field id=\"update_fields\" name=\"更新字段列表\" type=\"multiCheck\">     <rules>       <rule name=\"requiredRule\" value=\"true\"/>     </rules>     <values>       <value>title</value>     </values>   </field>   <field id=\"title\" name=\"商品标题\" type=\"input\">     <rules>       <rule name=\"valueTypeRule\" value=\"text\"/>       <rule name=\"minLengthRule\" value=\"1\" exProperty=\"include\" unit=\"byte\"/>       <rule name=\"maxLengthRule\" value=\"120\" exProperty=\"include\" unit=\"byte\"/>       <rule name=\"requiredRule\" value=\"true\"/>     </rules>     <value>测试请不要拍</value>   </field> </itemParam>";
TmallItemSchemaIncrementUpdateResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new TmallItemSchemaIncrementUpdateRequest;
$req->setItemId("2100529818899");
$req->setXmlData("<itemParam>   <field id=\"update_fields\" name=\"更新字段列表\" type=\"multiCheck\">     <rules>       <rule name=\"requiredRule\" value=\"true\"/>     </rules>     <values>       <value>title</value>     </values>   </field>   <field id=\"title\" name=\"商品标题\" type=\"input\">     <rules>       <rule name=\"valueTypeRule\" value=\"text\"/>       <rule name=\"minLengthRule\" value=\"1\" exProperty=\"include\" unit=\"byte\"/>       <rule name=\"maxLengthRule\" value=\"120\" exProperty=\"include\" unit=\"byte\"/>       <rule name=\"requiredRule\" value=\"true\"/>     </rules>     <value>测试请不要拍</value>   </field> </itemParam>");
$resp = $c->execute($req, $sessionKey);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=tmall.item.schema.increment.update' \
-d 'partner_id=apidoc' \
-d 'session=f0f81cf9-6e1c-48c3-a2db-d12526734975' \
-d 'sign=DFD5B07A182F4F9C9CC5242737BC9B13' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-04-24+16%3A04%3A14' \
-d 'v=2.0' \
-d 'item_id=2100529818899' \
-d 'xml_data=%3CitemParam%3E+++%3Cfield+id%3D%5C%22update_fields%5C%22+name%3D%5C%22%E6%9B%B4%E6%96%B0%E5%AD%97%E6%AE%B5%E5%88%97%E8%A1%A8%5C%22+type%3D%5C%22multiCheck%5C%22%3E+++++%3Crules%3E+++++++%3Crule+name%3D%5C%22requiredRule%5C%22+value%3D%5C%22true%5C%22%2F%3E+++++%3C%2Frules%3E+++++%3Cvalues%3E+++++++%3Cvalue%3Etitle%3C%2Fvalue%3E+++++%3C%2Fvalues%3E+++%3C%2Ffield%3E+++%3Cfield+id%3D%5C%22title%5C%22+name%3D%5C%22%E5%95%86%E5%93%81%E6%A0%87%E9%A2%98%5C%22+type%3D%5C%22input%5C%22%3E+++++%3Crules%3E+++++++%3Crule+name%3D%5C%22valueTypeRule%5C%22+value%3D%5C%22text%5C%22%2F%3E+++++++%3Crule+name%3D%5C%22minLengthRule%5C%22+value%3D%5C%221%5C%22+exProperty%3D%5C%22include%5C%22+unit%3D%5C%22byte%5C%22%2F%3E+++++++%3Crule+name%3D%5C%22maxLengthRule%5C%22+value%3D%5C%22120%5C%22+exProperty%3D%5C%22include%5C%22+unit%3D%5C%22byte%5C%22%2F%3E+++++++%3Crule+name%3D%5C%22requiredRule%5C%22+value%3D%5C%22true%5C%22%2F%3E+++++%3C%2Frules%3E+++++%3Cvalue%3E%E6%B5%8B%E8%AF%95%E8%AF%B7%E4%B8%8D%E8%A6%81%E6%8B%8D%3C%2Fvalue%3E+++%3C%2Ffield%3E+%3C%2FitemParam%3E'

# -*- coding: utf-8 -*-
import top.api

req=top.api.TmallItemSchemaIncrementUpdateRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.item_id=2100529818899
req.xml_data="<itemParam>   <field id=\"update_fields\" name=\"更新字段列表\" type=\"multiCheck\">     <rules>       <rule name=\"requiredRule\" value=\"true\"/>     </rules>     <values>       <value>title</value>     </values>   </field>   <field id=\"title\" name=\"商品标题\" type=\"input\">     <rules>       <rule name=\"valueTypeRule\" value=\"text\"/>       <rule name=\"minLengthRule\" value=\"1\" exProperty=\"include\" unit=\"byte\"/>       <rule name=\"maxLengthRule\" value=\"120\" exProperty=\"include\" unit=\"byte\"/>       <rule name=\"requiredRule\" value=\"true\"/>     </rules>     <value>测试请不要拍</value>   </field> </itemParam>"
try:
	resp= req.getResponse(sessionkey)
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"tmall.item.schema.increment.update");
add_param(pRequest,"item_id","2100529818899");
add_param(pRequest,"xml_data","<itemParam>   <field id=\"update_fields\" name=\"更新字段列表\" type=\"multiCheck\">     <rules>       <rule name=\"requiredRule\" value=\"true\"/>     </rules>     <values>       <value>title</value>     </values>   </field>   <field id=\"title\" name=\"商品标题\" type=\"input\">     <rules>       <rule name=\"valueTypeRule\" value=\"text\"/>       <rule name=\"minLengthRule\" value=\"1\" exProperty=\"include\" unit=\"byte\"/>       <rule name=\"maxLengthRule\" value=\"120\" exProperty=\"include\" unit=\"byte\"/>       <rule name=\"requiredRule\" value=\"true\"/>     </rules>     <value>测试请不要拍</value>   </field> </itemParam>");
pResponse = top_execute(pClient,pRequest,sessionKey);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('tmall.item.schema.increment.update', {
	'item_id':'2100529818899',
	'xml_data':'<itemParam>   <field id=\"update_fields\" name=\"更新字段列表\" type=\"multiCheck\">     <rules>       <rule name=\"requiredRule\" value=\"true\"/>     </rules>     <values>       <value>title</value>     </values>   </field>   <field id=\"title\" name=\"商品标题\" type=\"input\">     <rules>       <rule name=\"valueTypeRule\" value=\"text\"/>       <rule name=\"minLengthRule\" value=\"1\" exProperty=\"include\" unit=\"byte\"/>       <rule name=\"maxLengthRule\" value=\"120\" exProperty=\"include\" unit=\"byte\"/>       <rule name=\"requiredRule\" value=\"true\"/>     </rules>     <value>测试请不要拍</value>   </field> </itemParam>'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<tmall_item_schema_increment_update_response>
    <update_item_result>12345</update_item_result>
    <gmt_modified>2015-11-11 00:00:00</gmt_modified>
</tmall_item_schema_increment_update_response>

{
    "tmall_item_schema_increment_update_response":{
        "update_item_result":"12345",
        "gmt_modified":"2015-11-11 00:00:00"
    }
}

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>

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码	错误描述	解决方案
isv.invalid-parameter:item_id	没有找到商品，请确认商品是否存在或者已删除	没有找到商品，请确认商品是否存在或者已删除
isv.item-service-error:IC_ITEM_TITLE_IS_TOO_LONG	宝贝标题最多不能超过60个字节（30个汉字）	宝贝标题最多不能超过60个字节（30个汉字）
isv.item-service-error:IC_ITEM_DESC_IS_TOO_LONG	宝贝描述在5-25000字以内	宝贝描述在5-25000字以内
isv.item-service-error:DRAFT_AUCTION_ONLY_DRAFTPUBLISH_EDIT	草稿状态中的商品，只能进行草稿发布或者全量编辑	草稿状态中的商品，只能进行草稿发布或者全量编辑
isv.item-service-error:IC_ITEM_DESC_TOO_LONG	宝贝描述长度超过允许范围	宝贝描述长度超过允许范围
isv.item-service-error:IC_CHECKSTEP_SKU_DUPLICATE	宝贝销售属性出错（重复），请重新编辑	宝贝销售属性出错（重复），请重新编辑
isv.item-service-error:TITLE_INCLUDE_FORBID_WORD_AGAIN	宝贝标题不符合规范，包含违禁字:“${FORBID_WORD}”,请您自查	宝贝标题不符合规范，包含违禁字:“${FORBID_WORD}”,请您自查
isv.item-service-error:IC_ITEM_DESC_COULD_NOT_BE_EMPTY	宝贝描述不能为空	宝贝描述不能为空
isv.item-service-error:IC_CHECKSTEP_SKU_PROP_NOT_SALE	宝贝销售属性出错（非销售属性），请重新编辑	宝贝销售属性出错（非销售属性），请重新编辑
isv.item-service-error:ITEM_IS_NOT_BELONG_TO_SELLER	对不起，您不能操作不属于您的商品	对不起，您不能操作不属于您的商品
isv.item-service-error:IC_LIMIT_FOR_DPC	供应商限制该分销商品修改:${detailLimits}如有疑问请咨询供应商的分销销售控制	供应商限制该分销商品修改:${detailLimits}如有疑问请咨询供应商的分销销售控制
isv.item-service-error:FORBIDDEN_DPC_ITEM_UPSHELF	分销产品撤回，不允许上架	分销产品撤回，不允许上架
isv.item-service-error:IC_PERMISSION_FOR_WT_ONLY	该宝贝只允许通过网厅平台进行相关操作	该宝贝只允许通过网厅平台进行相关操作
isv.item-service-error:DESC_INCLUDE_FORBID_WORD	描述包含违禁字:“${FORBID_WORD}”,请您自查	描述包含违禁字:“${FORBID_WORD}”,请您自查
isv.item-service-error:IC_CHECKSTEP_NO_PERMISSION	您未通过认证或已被处罚，请核实	您未通过认证或已被处罚，请核实
isv.item-service-error:IC_PERMISSION_FOR_SECOND_KILL	您的这个宝贝处于秒杀活动中，不能进行编辑，可以下架但不能再上架，如果秒杀结束需要自由编辑请联系活动负责人去掉秒杀标记	您的这个宝贝处于秒杀活动中，不能进行编辑，可以下架但不能再上架，如果秒杀结束需要自由编辑请联系活动负责人去掉秒杀标记
isv.item-service-error:IC_CATEGORY_FREEZE	因类目调整当前类目已被淘宝网关闭，请您将商品发布在其他相应类目下	因类目调整当前类目已被淘宝网关闭，请您将商品发布在其他相应类目下
isp.item-service-error:GENERIC_FAILURE	系统错误，请稍后再试	系统错误，请稍后再试
isv.item-service-error:FORBIDDEN_QUANTITY_ZERO_ERROR	上架的数量必须大于0	上架的数量必须大于0
isp.item-service-error:IC_SYSTEM_NOT_READY_TRY_AGAIN_LATER	系统繁忙，请稍候再次尝试	系统繁忙，请稍候再次尝试
isv.item-service-error:IC_CHECK_BARCODE_ERROR	条形码信息格式异常:${errorBarcode}	条形码信息格式异常:${errorBarcode}
isv.item-service-error:IC_CHECKSTEP_SKU_NOT_FIT_CATEGORY_MODE	销售属性不符合类目配置，请重新编辑	销售属性不符合类目配置，请重新编辑
isp.item-service-error:QUERY_USER_INFO_ERROR	系统错误，获取用户数据失败	系统错误，获取用户数据失败
isv.invalid-parameter:title	商品标题长度不能超过60个字节（30个汉字）	控制标题长度
isv.invalid-parameter:wireless_desc	wireless_desc属性格式不正确	请检查wireless_desc属性，修改后再提交
isv.invalid-parameter:update_fields	update_fields属性格式不正确	请检查update_fields属性，修改后再提交
isp.tmall_item_service_error	服务错误，稍后重试	服务错误，稍后重试
isv.invalid-permission:item-deleted	商品已删除	换正确的商品id
isp.tmallitem-service-error:empty	系统异常	请稍后重试
isv.item-service-error:RULE_TMALL_HUAZHUANGPIN118338_TOP_NOT_PERMIT_TO_EDIT	此商品暂不支持top编辑	此商品已通过化妆品校验，暂不支持top编辑，请使用天猫商品管理后台进行编辑
isv.invalid-permission:update_item	该商品不属于当前用户	获取当前用户的商品重试
isv.item-service-error:ERR_RULE_CATEGORY_CANNOT_BLANK	选择的类目不存在或者不是叶子类目	请重新编辑商品
isv.parameter-parase-error:xml_data	入参数据无法被转换识别	参数格式错误，参考api文档说明入参
isv.item-service-error:ITEM_NOT_FOUND	商品找不到	请确认商品是否正确
isv.invalid-permission:publish_itemupdate_item	C卖家没有调用天猫服务层接口发布或编辑商品的权限	带tmall 字样的schema接口，仅支持天猫商家；淘宝用户使用带taobao 字样的schema接口
isv.invalid-parameter:cid	商品cid参数异常	请检查商品cid参数
isp.item-service-unavailable	服务异常，请稍候重试	服务异常，请稍候重试
isv.item-service-error:ERR_RULE_ITEM_PUB_QUANTITY_LIMIT_TMALL_CAR	在该一级类目下出售中商品总数已超过此类目商品数量限额	您的店铺在该一级类目下出售中商品总数已超过此类目商品数量限额，请您及时调整您的商品数量，再上传商品，详见：https://service.tmall.com/support/tmall/knowledge-13115881.htm
isv.invalid-parameter:description	description属性格式不正确	请检查description属性格式，修改后再提交
isv.item-service-error:IC_OPTIMISTIC_LOCKING_CONFLICT	商品更新频次太快	商品更新频次太快，请降低商家下更新频率
isv.invalid-parameter:item_images	item_images属性格式不正确	请检查item_images属性，修改后再提交
isv.missing-parameter:description	description属性未添加	请检查description属性，填充完整后再提交
isv.invalid-parameter:sell_points	sell_points属性格式不正确	请检查sell_points属性，修改后再提交
isv.parameter-parse-error:xml_data	提交的商品schema信息格式不正确	请检查提交的商品schema信息
isv.parameter-parse-error:wap_desc	提交的wap_desc格式信息不正确	请检查wap_desc格式
isv.item-service-error:ERR_RULE_TMALL_YANGCHE_FUWU_LIMIT	该类目在售商品需要提供安装服务	该类目在售商品需要提供安装服务，详情请查看https://rule.tmall.com/tdetail-11000546.htm?spm=a223k.10053284.8595313088.7.9e4163d3zSxvgt&tag=self 服务设置咨询，请加钉钉群23149333
SYS_REQUEST_TOO_FAST	请求过快，请降低请求频率	请将单个商家调用频率降低至每分钟4000次以内

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

淘宝商品API

tmall.item.schema.increment.update (天猫根据规则增量更新商品)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ