淘宝开放平台 - 文档中心

请求地址：

环境	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。

名称	类型	是否必须	示例值	更多限制	描述
category_id	Number	必须	234545		所属类目id，参考Taobao.itemcats.get，不支持成人等类目，输入成人类目id保存提示类目属性错误。
name	String	必须	裙子		产品名称，长度不超过60个字节。
productcat_id	Number	必须	555		产品线ID
standard_price	String	必须	10.56		采购基准价格，单位：元。例：“10.56”。必须在0.01元到10000000元之间。
standard_retail_price	String	可选	10.56		零售基准价，单位：元。例：“10.56”。必须在0.01元到10000000元之间。
retail_price_low	String	必须	10.56		最低零售价，单位：元。例：“10.56”。必须在0.01元到10000000元之间。
retail_price_high	String	必须	10.56		最高零售价，单位：元。例：“10.56”。必须在0.01元到10000000元之间，最高零售价必须大于最低零售价。
cost_price	String	可选	10.56		代销采购价格，单位：元。例：“10.56”。必须在0.01元到10000000元之间。
dealer_cost_price	String	可选	12.3		经销采购价，单位：元。例：“10.56”。必须在0.01元到10000000元之间。
outer_id	String	可选	hz000014		商家编码，长度不能超过60个字节。
quantity	Number	必须	100		产品库存必须是1到999999。
desc	String	必须	产品描述		产品描述，长度为5到25000字符。
prov	String	必须	浙江		所在地：省，例：“浙江”
city	String	必须	杭州		所在地：市，例：“杭州”
postage_type	String	可选	buyer		运费类型，可选值：seller（供应商承担运费）、buyer（分销商承担运费）,默认seller。
postage_id	Number	可选	555		运费模板ID，参考taobao.postages.get。
postage_ordinary	String	可选	10.56		平邮费用，单位：元。例：“10.56”。大小为0.01元到999999元之间。
postage_fast	String	可选	10.56		快递费用，单位：元。例：“10.56”。大小为0.01元到999999元之间。
postage_ems	String	可选	10.56		ems费用，单位：元。例：“10.56”。大小为0.00元到999999元之间。
have_invoice	String	可选	true		是否有发票，可选值：false（否）、true（是），默认false。
have_quarantee	String	可选	true		是否有保修，可选值：false（否）、true（是），默认false。
discount_id	Number	可选	1234		折扣ID
trade_type	String	可选	AGENT		分销方式：AGENT（只做代销，默认值）、DEALER（只做经销）、ALL（代销和经销都做）
is_authz	String	可选	yes	默认值：yes	添加产品时，添加入参isAuthz:yes\|no yes:需要授权 no:不需要授权默认是需要授权
pic_path	String	可选	i5/T13WhcXglfXXbX2p.0_034216.jpg		产品主图图片空间相对路径或绝对路径
image	byte[]	可选	产品主图		产品主图，大小不超过500k，格式为gif,jpg,jpeg,png,bmp等图片
properties	String	可选	1631357:21846512;20000:21918302		产品属性，格式为pid:vid;pid:vid
property_alias	String	可选	1627207:28335:绿荫色		属性别名，格式为：pid:vid:alias;pid:vid:alias（alias为别名）
input_properties	String	可选	20000:品牌名		自定义属性。格式为pid:value;pid:value
sku_standard_prices	String	可选	2.3,25		sku的采购基准价。如果多个，用逗号分隔，并与其他sku信息保持相同顺序
sku_cost_prices	String	可选	2.3,32		sku的采购价。如果多个，用逗号分隔，并与其他sku信息保持相同顺序
sku_outer_ids	String	可选	abc,123		sku的商家编码。如果多个，用逗号分隔，并与其他sku信息保持相同顺序
sku_quantitys	String	可选	10,20		sku的库存。如果多个，用逗号分隔，并与其他sku信息保持相同顺序
sku_properties	String	可选	1627207:28335;1630696:3266779		sku的属性。如果多个，用逗号分隔，并与其他sku信息保持相同顺序
sku_dealer_cost_prices	String	可选	12.3,12,5		sku的经销采购价。如果多个，用逗号分隔，并与其他sku信息保持相同顺序。其中每个值的单位：元。例：“10.56,12.3”。必须在0.01元到10000000元之间。
item_id	Number	可选	1001		导入的商品ID
spu_id	Number	可选	123456		产品spuID，达尔文产品必须要传spuID，否则不能发布。其他非达尔文产品，看情况传

名称	类型	示例值	描述
pid	Number	5522	产品ID
created	Date	2000-01-01 00:00:00	产品创建时间时间格式：yyyy-MM-dd HH:mm:ss

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
FenxiaoProductAddRequest req = new FenxiaoProductAddRequest();
req.setCategoryId(234545L);
req.setName("裙子");
req.setProductcatId(555L);
req.setStandardPrice("10.56");
req.setStandardRetailPrice("10.56");
req.setRetailPriceLow("10.56");
req.setRetailPriceHigh("10.56");
req.setCostPrice("10.56");
req.setDealerCostPrice("12.3");
req.setOuterId("hz000014");
req.setQuantity(100L);
req.setDesc("产品描述");
req.setProv("浙江");
req.setCity("杭州");
req.setPostageType("buyer");
req.setPostageId(555L);
req.setPostageOrdinary("10.56");
req.setPostageFast("10.56");
req.setPostageEms("10.56");
req.setHaveInvoice("true");
req.setHaveQuarantee("true");
req.setDiscountId(1234L);
req.setTradeType("AGENT");
req.setIsAuthz("yes");
req.setPicPath("i5/T13WhcXglfXXbX2p.0_034216.jpg");
req.setImage(new FileItem("/tmp/file.txt"));
req.setProperties("1631357:21846512;20000:21918302");
req.setPropertyAlias("1627207:28335:绿荫色");
req.setInputProperties("20000:品牌名");
req.setSkuStandardPrices("2.3,25");
req.setSkuCostPrices("2.3,32");
req.setSkuOuterIds("abc,123");
req.setSkuQuantitys("10,20");
req.setSkuProperties("1627207:28335;1630696:3266779");
req.setSkuDealerCostPrices("12.3,12,5");
req.setItemId(1001L);
req.setSpuId(123456L);
FenxiaoProductAddResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
FenxiaoProductAddRequest req = new FenxiaoProductAddRequest();
req.CategoryId = 234545L;
req.Name = "裙子";
req.ProductcatId = 555L;
req.StandardPrice = "10.56";
req.StandardRetailPrice = "10.56";
req.RetailPriceLow = "10.56";
req.RetailPriceHigh = "10.56";
req.CostPrice = "10.56";
req.DealerCostPrice = "12.3";
req.OuterId = "hz000014";
req.Quantity = 100L;
req.Desc = "产品描述";
req.Prov = "浙江";
req.City = "杭州";
req.PostageType = "buyer";
req.PostageId = 555L;
req.PostageOrdinary = "10.56";
req.PostageFast = "10.56";
req.PostageEms = "10.56";
req.HaveInvoice = "true";
req.HaveQuarantee = "true";
req.DiscountId = 1234L;
req.TradeType = "AGENT";
req.IsAuthz = "yes";
req.PicPath = "i5/T13WhcXglfXXbX2p.0_034216.jpg";
req.Image = new FileItem("/tmp/file.txt");
req.Properties = "1631357:21846512;20000:21918302";
req.PropertyAlias = "1627207:28335:绿荫色";
req.InputProperties = "20000:品牌名";
req.SkuStandardPrices = "2.3,25";
req.SkuCostPrices = "2.3,32";
req.SkuOuterIds = "abc,123";
req.SkuQuantitys = "10,20";
req.SkuProperties = "1627207:28335;1630696:3266779";
req.SkuDealerCostPrices = "12.3,12,5";
req.ItemId = 1001L;
req.SpuId = 123456L;
FenxiaoProductAddResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new FenxiaoProductAddRequest;
$req->setCategoryId("234545");
$req->setName("裙子");
$req->setProductcatId("555");
$req->setStandardPrice("10.56");
$req->setStandardRetailPrice("10.56");
$req->setRetailPriceLow("10.56");
$req->setRetailPriceHigh("10.56");
$req->setCostPrice("10.56");
$req->setDealerCostPrice("12.3");
$req->setOuterId("hz000014");
$req->setQuantity("100");
$req->setDesc("产品描述");
$req->setProv("浙江");
$req->setCity("杭州");
$req->setPostageType("buyer");
$req->setPostageId("555");
$req->setPostageOrdinary("10.56");
$req->setPostageFast("10.56");
$req->setPostageEms("10.56");
$req->setHaveInvoice("true");
$req->setHaveQuarantee("true");
$req->setDiscountId("1234");
$req->setTradeType("AGENT");
$req->setIsAuthz("yes");
$req->setPicPath("i5/T13WhcXglfXXbX2p.0_034216.jpg");
//附件上传的机制参见PHP CURL文档，在文件路径前加@符号即可
$req->setImage(@fileLocation);
$req->setProperties("1631357:21846512;20000:21918302");
$req->setPropertyAlias("1627207:28335:绿荫色");
$req->setInputProperties("20000:品牌名");
$req->setSkuStandardPrices("2.3,25");
$req->setSkuCostPrices("2.3,32");
$req->setSkuOuterIds("abc,123");
$req->setSkuQuantitys("10,20");
$req->setSkuProperties("1627207:28335;1630696:3266779");
$req->setSkuDealerCostPrices("12.3,12,5");
$req->setItemId("1001");
$req->setSpuId("123456");
$resp = $c->execute($req, $sessionKey);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:multipart/form-data;charset=utf-8' \
-F 'app_key=12129701' \
-F 'format=json' \
-F 'method=taobao.fenxiao.product.add' \
-F 'partner_id=apidoc' \
-F 'session=cc99b6b2-c76b-40d4-bf6a-fe3188810615' \
-F 'sign=C3C15A285E524D02F4272090A13AAA69' \
-F 'sign_method=hmac' \
-F 'timestamp=2025-04-25+18%3A45%3A21' \
-F 'v=2.0' \
-F 'category_id=234545' \
-F 'city=%E6%9D%AD%E5%B7%9E' \
-F 'cost_price=10.56' \
-F 'dealer_cost_price=12.3' \
-F 'desc=%E4%BA%A7%E5%93%81%E6%8F%8F%E8%BF%B0' \
-F 'discount_id=1234' \
-F 'have_invoice=true' \
-F 'have_quarantee=true' \
-F 'input_properties=20000%3A%E5%93%81%E7%89%8C%E5%90%8D' \
-F 'is_authz=yes' \
-F 'item_id=1001' \
-F 'name=%E8%A3%99%E5%AD%90' \
-F 'outer_id=hz000014' \
-F 'pic_path=i5%2FT13WhcXglfXXbX2p.0_034216.jpg' \
-F 'postage_ems=10.56' \
-F 'postage_fast=10.56' \
-F 'postage_id=555' \
-F 'postage_ordinary=10.56' \
-F 'postage_type=buyer' \
-F 'productcat_id=555' \
-F 'properties=1631357%3A21846512%3B20000%3A21918302' \
-F 'property_alias=1627207%3A28335%3A%E7%BB%BF%E8%8D%AB%E8%89%B2' \
-F 'prov=%E6%B5%99%E6%B1%9F' \
-F 'quantity=100' \
-F 'retail_price_high=10.56' \
-F 'retail_price_low=10.56' \
-F 'sku_cost_prices=2.3%2C32' \
-F 'sku_dealer_cost_prices=12.3%2C12%2C5' \
-F 'sku_outer_ids=abc%2C123' \
-F 'sku_properties=1627207%3A28335%3B1630696%3A3266779' \
-F 'sku_quantitys=10%2C20' \
-F 'sku_standard_prices=2.3%2C25' \
-F 'spu_id=123456' \
-F 'standard_price=10.56' \
-F 'standard_retail_price=10.56' \
-F 'trade_type=AGENT' \
-F 'image=@/tmp/file.txt'

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

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

req.category_id=234545
req.name="裙子"
req.productcat_id=555
req.standard_price="10.56"
req.standard_retail_price="10.56"
req.retail_price_low="10.56"
req.retail_price_high="10.56"
req.cost_price="10.56"
req.dealer_cost_price="12.3"
req.outer_id="hz000014"
req.quantity=100
req.desc="产品描述"
req.prov="浙江"
req.city="杭州"
req.postage_type="buyer"
req.postage_id=555
req.postage_ordinary="10.56"
req.postage_fast="10.56"
req.postage_ems="10.56"
req.have_invoice="true"
req.have_quarantee="true"
req.discount_id=1234
req.trade_type="AGENT"
req.is_authz="yes"
req.pic_path="i5/T13WhcXglfXXbX2p.0_034216.jpg"
req.image=top.api.FileItem('abc.jpg',open('abc.jpg','rb'))
req.properties="1631357:21846512;20000:21918302"
req.property_alias="1627207:28335:绿荫色"
req.input_properties="20000:品牌名"
req.sku_standard_prices="2.3,25"
req.sku_cost_prices="2.3,32"
req.sku_outer_ids="abc,123"
req.sku_quantitys="10,20"
req.sku_properties="1627207:28335;1630696:3266779"
req.sku_dealer_cost_prices="12.3,12,5"
req.item_id=1001
req.spu_id=123456
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,"taobao.fenxiao.product.add");
add_param(pRequest,"category_id","234545");
add_param(pRequest,"name","裙子");
add_param(pRequest,"productcat_id","555");
add_param(pRequest,"standard_price","10.56");
add_param(pRequest,"standard_retail_price","10.56");
add_param(pRequest,"retail_price_low","10.56");
add_param(pRequest,"retail_price_high","10.56");
add_param(pRequest,"cost_price","10.56");
add_param(pRequest,"dealer_cost_price","12.3");
add_param(pRequest,"outer_id","hz000014");
add_param(pRequest,"quantity","100");
add_param(pRequest,"desc","产品描述");
add_param(pRequest,"prov","浙江");
add_param(pRequest,"city","杭州");
add_param(pRequest,"postage_type","buyer");
add_param(pRequest,"postage_id","555");
add_param(pRequest,"postage_ordinary","10.56");
add_param(pRequest,"postage_fast","10.56");
add_param(pRequest,"postage_ems","10.56");
add_param(pRequest,"have_invoice","true");
add_param(pRequest,"have_quarantee","true");
add_param(pRequest,"discount_id","1234");
add_param(pRequest,"trade_type","AGENT");
add_param(pRequest,"is_authz","yes");
add_param(pRequest,"pic_path","i5/T13WhcXglfXXbX2p.0_034216.jpg");
add_file_param(pRequest,"image","文件内容");
add_param(pRequest,"properties","1631357:21846512;20000:21918302");
add_param(pRequest,"property_alias","1627207:28335:绿荫色");
add_param(pRequest,"input_properties","20000:品牌名");
add_param(pRequest,"sku_standard_prices","2.3,25");
add_param(pRequest,"sku_cost_prices","2.3,32");
add_param(pRequest,"sku_outer_ids","abc,123");
add_param(pRequest,"sku_quantitys","10,20");
add_param(pRequest,"sku_properties","1627207:28335;1630696:3266779");
add_param(pRequest,"sku_dealer_cost_prices","12.3,12,5");
add_param(pRequest,"item_id","1001");
add_param(pRequest,"spu_id","123456");
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('taobao.fenxiao.product.add', {
	'category_id':'234545',
	'name':'裙子',
	'productcat_id':'555',
	'standard_price':'10.56',
	'standard_retail_price':'10.56',
	'retail_price_low':'10.56',
	'retail_price_high':'10.56',
	'cost_price':'10.56',
	'dealer_cost_price':'12.3',
	'outer_id':'hz000014',
	'quantity':'100',
	'desc':'产品描述',
	'prov':'浙江',
	'city':'杭州',
	'postage_type':'buyer',
	'postage_id':'555',
	'postage_ordinary':'10.56',
	'postage_fast':'10.56',
	'postage_ems':'10.56',
	'have_invoice':'true',
	'have_quarantee':'true',
	'discount_id':'1234',
	'trade_type':'AGENT',
	'is_authz':'yes',
	'pic_path':'i5/T13WhcXglfXXbX2p.0_034216.jpg',
	'image':'文件内容',
	'properties':'1631357:21846512;20000:21918302',
	'property_alias':'1627207:28335:绿荫色',
	'input_properties':'20000:品牌名',
	'sku_standard_prices':'2.3,25',
	'sku_cost_prices':'2.3,32',
	'sku_outer_ids':'abc,123',
	'sku_quantitys':'10,20',
	'sku_properties':'1627207:28335;1630696:3266779',
	'sku_dealer_cost_prices':'12.3,12,5',
	'item_id':'1001',
	'spu_id':'123456'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<fenxiao_product_add_response>
    <pid>5522</pid>
    <created>2000-01-01 00:00:00</created>
</fenxiao_product_add_response>

{
    "fenxiao_product_add_response":{
        "pid":5522,
        "created":"2000-01-01 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"
	}
}

错误码	错误描述	解决方案

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

开放平台

分销

taobao.fenxiao.product.add (添加产品)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ