淘宝开放平台 - 文档中心

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
param_open_spu_save_dto	OpenSpuSaveDto	必须			入参
└ allow_adding Boolean 可选 true 是否允许新增true/false └ category_id Number 必须 51101111 类目id color_images ColorImageVo [] 可选颜色图 └ image_url String 可选 http://sss 图片url └ pv_id String 可选 11111:22222 颜色属性值对 └ prop_name String 可选颜色属性项名称，如：颜色、规格 └ prop_value String 可选白色属性值，如：白色 cspus OpenCspuSaveDto [] 必须 Cspu 最大列表长度：100 └ art_no String 必须 1111111 货号 └ barcode String 必须 11111 条码 └ outer_id String 必须 111111 外部id props GoodsPropertyDto [] 必须销售属性 └ property_id String 可选 1111 属性id └ property_name String 必须颜色分类属性name └ property_sort_order Number 可选 1 属性排序 └ value_custom_name String 可选颜色自定义名称 └ value_id String 可选 111 属性值id └ value_name String 必须红色属性值name └ value_sort_order Number 可选 1 属性值排序 └ tag_price Number 可选 1000 吊牌价单位分【只在新增时有效，更新时无效】 └ title String 可选测试单品标题 detail_images ImageVo [] 可选详情图宽度以750像素~2000像素为佳,单张高度≤1546像素。整体详情图宽度保持一致,详情中所有图片总高度不得低于1500像素，数量不大于20条 └ height Number 可选 200 高 └ position Number 可选 1 排序 └ url String 可选 url url └ width Number 可选 1000 宽 └ intime_brand_id Number 必须 11328 银泰品牌 main_images ImageVo [] 可选主图宽高不能小于700,不能大于4000；比例只能为1：1，数量不大于20条 └ height Number 可选 800 高 └ position Number 可选 1 排序 └ url String 可选 url 图片url └ width Number 可选 800 宽 props GoodsPropertyDto [] 可选类目属性 └ property_id String 可选 1111 属性id └ property_name String 可选产地属性 └ property_sort_order Number 可选 1 属性排序 └ value_custom_name String 可选北京自定义属性 └ value_id String 可选 1111 属性值id └ value_name String 可选北京属性值 └ value_sort_order Number 可选 1 属性值排序 └ short_title String 可选短标题短标题 └ style_no String 必须 TM2020212 款号 └ title String 必须测试标题标题 └ goods_type String 可选 NORMAL 目前只支持赠品(GIVEAWAY)和普通商品(NORMAL) 默认 NORMAL GIVEAWAY three_to_four_images ImageVO [] 可选 {"height":1000,"position":0,"url":"https://xxx.com/image/aaaaaa.jpg","width":750} 3:4主图宽度不能小于600，不能大于400；比例只能3:4，数量不大于20条 └ height Number 可选 750 高 └ position Number 可选 0 排序 └ url String 可选 url 图片url └ width Number 可选 100 宽

名称	类型	示例值	描述
data	SpuSaveResponse	true	是否成功
cspus BarcodeCspu [] {} cspuList └ barcode String TM111111 条码 └ cspu_id Number 1000200001234 cspuId └ spu_id Number 1000200001231 spuid
tips_msg	String	提示	提示信息

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaMosGoodsOpenSpuSaveRequest req = new AlibabaMosGoodsOpenSpuSaveRequest();
AlibabaMosGoodsOpenSpuSaveRequest.OpenSpuSaveDto obj1 = new AlibabaMosGoodsOpenSpuSaveRequest.OpenSpuSaveDto();
obj1.setAllowAdding(true);
obj1.setCategoryId(51101111L);
List<AlibabaMosGoodsOpenSpuSaveRequest.ColorImageVo> list3 = new ArrayList<AlibabaMosGoodsOpenSpuSaveRequest.ColorImageVo>();
AlibabaMosGoodsOpenSpuSaveRequest.ColorImageVo obj4 = new AlibabaMosGoodsOpenSpuSaveRequest.ColorImageVo();
list3.add(obj4);
obj4.setImageUrl("http://sss");
obj4.setPvId("11111:22222");
obj4.setPropName("颜色");
obj4.setPropValue("白色");
obj1.setColorImages(list3);
List<AlibabaMosGoodsOpenSpuSaveRequest.OpenCspuSaveDto> list6 = new ArrayList<AlibabaMosGoodsOpenSpuSaveRequest.OpenCspuSaveDto>();
AlibabaMosGoodsOpenSpuSaveRequest.OpenCspuSaveDto obj7 = new AlibabaMosGoodsOpenSpuSaveRequest.OpenCspuSaveDto();
list6.add(obj7);
obj7.setArtNo("1111111");
obj7.setBarcode("11111");
obj7.setOuterId("111111");
List<AlibabaMosGoodsOpenSpuSaveRequest.GoodsPropertyDto> list10 = new ArrayList<AlibabaMosGoodsOpenSpuSaveRequest.GoodsPropertyDto>();
AlibabaMosGoodsOpenSpuSaveRequest.GoodsPropertyDto obj11 = new AlibabaMosGoodsOpenSpuSaveRequest.GoodsPropertyDto();
list10.add(obj11);
obj11.setPropertyId("1111");
obj11.setPropertyName("颜色分类");
obj11.setPropertySortOrder(1L);
obj11.setValueCustomName("颜色");
obj11.setValueId("111");
obj11.setValueName("红色");
obj11.setValueSortOrder(1L);
list8.setProps(list10);
obj7.setTagPrice(1000L);
obj7.setTitle("测试");
obj1.setCspus(list6);
List<AlibabaMosGoodsOpenSpuSaveRequest.ImageVo> list13 = new ArrayList<AlibabaMosGoodsOpenSpuSaveRequest.ImageVo>();
AlibabaMosGoodsOpenSpuSaveRequest.ImageVo obj14 = new AlibabaMosGoodsOpenSpuSaveRequest.ImageVo();
list13.add(obj14);
obj14.setHeight(200L);
obj14.setPosition(1L);
obj14.setUrl("url");
obj14.setWidth(1000L);
obj1.setDetailImages(list13);
obj1.setIntimeBrandId(11328L);
List<AlibabaMosGoodsOpenSpuSaveRequest.ImageVo> list16 = new ArrayList<AlibabaMosGoodsOpenSpuSaveRequest.ImageVo>();
AlibabaMosGoodsOpenSpuSaveRequest.ImageVo obj17 = new AlibabaMosGoodsOpenSpuSaveRequest.ImageVo();
list16.add(obj17);
obj17.setHeight(800L);
obj17.setPosition(1L);
obj17.setUrl("url");
obj17.setWidth(800L);
obj1.setMainImages(list16);
List<AlibabaMosGoodsOpenSpuSaveRequest.GoodsPropertyDto> list19 = new ArrayList<AlibabaMosGoodsOpenSpuSaveRequest.GoodsPropertyDto>();
AlibabaMosGoodsOpenSpuSaveRequest.GoodsPropertyDto obj20 = new AlibabaMosGoodsOpenSpuSaveRequest.GoodsPropertyDto();
list19.add(obj20);
obj20.setPropertyId("1111");
obj20.setPropertyName("产地");
obj20.setPropertySortOrder(1L);
obj20.setValueCustomName("北京");
obj20.setValueId("1111");
obj20.setValueName("北京");
obj20.setValueSortOrder(1L);
obj1.setProps(list19);
obj1.setShortTitle("短标题");
obj1.setStyleNo("TM2020212");
obj1.setTitle("测试标题");
obj1.setGoodsType("NORMAL");
List<AlibabaMosGoodsOpenSpuSaveRequest.ImageVO> list22 = new ArrayList<AlibabaMosGoodsOpenSpuSaveRequest.ImageVO>();
AlibabaMosGoodsOpenSpuSaveRequest.ImageVO obj23 = new AlibabaMosGoodsOpenSpuSaveRequest.ImageVO();
list22.add(obj23);
obj23.setHeight(750L);
obj23.setPosition(0L);
obj23.setUrl("url");
obj23.setWidth(100L);
obj1.setThreeToFourImages(list22);
req.setParamOpenSpuSaveDto(obj1);
AlibabaMosGoodsOpenSpuSaveResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaMosGoodsOpenSpuSaveRequest req = new AlibabaMosGoodsOpenSpuSaveRequest();
AlibabaMosGoodsOpenSpuSaveRequest.OpenSpuSaveDtoDomain obj1 = new AlibabaMosGoodsOpenSpuSaveRequest.OpenSpuSaveDtoDomain();
obj1.AllowAdding = true;
obj1.CategoryId = 51101111L;
List<AlibabaMosGoodsOpenSpuSaveRequest.ColorImageVoDomain> list3 = new List<AlibabaMosGoodsOpenSpuSaveRequest.ColorImageVoDomain>();
AlibabaMosGoodsOpenSpuSaveRequest.ColorImageVoDomain obj4 = new AlibabaMosGoodsOpenSpuSaveRequest.ColorImageVoDomain();
list3.Add(obj4);
obj4.ImageUrl = "http://sss";
obj4.PvId = "11111:22222";
obj4.PropName = "颜色";
obj4.PropValue = "白色";
obj1.ColorImages= list3;
List<AlibabaMosGoodsOpenSpuSaveRequest.OpenCspuSaveDtoDomain> list6 = new List<AlibabaMosGoodsOpenSpuSaveRequest.OpenCspuSaveDtoDomain>();
AlibabaMosGoodsOpenSpuSaveRequest.OpenCspuSaveDtoDomain obj7 = new AlibabaMosGoodsOpenSpuSaveRequest.OpenCspuSaveDtoDomain();
list6.Add(obj7);
obj7.ArtNo = "1111111";
obj7.Barcode = "11111";
obj7.OuterId = "111111";
List<AlibabaMosGoodsOpenSpuSaveRequest.GoodsPropertyDtoDomain> list9 = new List<AlibabaMosGoodsOpenSpuSaveRequest.GoodsPropertyDtoDomain>();
AlibabaMosGoodsOpenSpuSaveRequest.GoodsPropertyDtoDomain obj10 = new AlibabaMosGoodsOpenSpuSaveRequest.GoodsPropertyDtoDomain();
list9.Add(obj10);
obj10.PropertyId = "1111";
obj10.PropertyName = "颜色分类";
obj10.PropertySortOrder = 1L;
obj10.ValueCustomName = "颜色";
obj10.ValueId = "111";
obj10.ValueName = "红色";
obj10.ValueSortOrder = 1L;
obj7.Props= list9;
obj7.TagPrice = 1000L;
obj7.Title = "测试";
obj1.Cspus= list6;
List<AlibabaMosGoodsOpenSpuSaveRequest.ImageVoDomain> list12 = new List<AlibabaMosGoodsOpenSpuSaveRequest.ImageVoDomain>();
AlibabaMosGoodsOpenSpuSaveRequest.ImageVoDomain obj13 = new AlibabaMosGoodsOpenSpuSaveRequest.ImageVoDomain();
list12.Add(obj13);
obj13.Height = 200L;
obj13.Position = 1L;
obj13.Url = "url";
obj13.Width = 1000L;
obj1.DetailImages= list12;
obj1.IntimeBrandId = 11328L;
List<AlibabaMosGoodsOpenSpuSaveRequest.ImageVoDomain> list15 = new List<AlibabaMosGoodsOpenSpuSaveRequest.ImageVoDomain>();
AlibabaMosGoodsOpenSpuSaveRequest.ImageVoDomain obj16 = new AlibabaMosGoodsOpenSpuSaveRequest.ImageVoDomain();
list15.Add(obj16);
obj16.Height = 800L;
obj16.Position = 1L;
obj16.Url = "url";
obj16.Width = 800L;
obj1.MainImages= list15;
List<AlibabaMosGoodsOpenSpuSaveRequest.GoodsPropertyDtoDomain> list18 = new List<AlibabaMosGoodsOpenSpuSaveRequest.GoodsPropertyDtoDomain>();
AlibabaMosGoodsOpenSpuSaveRequest.GoodsPropertyDtoDomain obj19 = new AlibabaMosGoodsOpenSpuSaveRequest.GoodsPropertyDtoDomain();
list18.Add(obj19);
obj19.PropertyId = "1111";
obj19.PropertyName = "产地";
obj19.PropertySortOrder = 1L;
obj19.ValueCustomName = "北京";
obj19.ValueId = "1111";
obj19.ValueName = "北京";
obj19.ValueSortOrder = 1L;
obj1.Props= list18;
obj1.ShortTitle = "短标题";
obj1.StyleNo = "TM2020212";
obj1.Title = "测试标题";
obj1.GoodsType = "NORMAL";
List<AlibabaMosGoodsOpenSpuSaveRequest.ImageVODomain> list21 = new List<AlibabaMosGoodsOpenSpuSaveRequest.ImageVODomain>();
AlibabaMosGoodsOpenSpuSaveRequest.ImageVODomain obj22 = new AlibabaMosGoodsOpenSpuSaveRequest.ImageVODomain();
list21.Add(obj22);
obj22.Height = 750L;
obj22.Position = 0L;
obj22.Url = "url";
obj22.Width = 100L;
obj1.ThreeToFourImages= list21;
req.ParamOpenSpuSaveDto_ = obj1;
AlibabaMosGoodsOpenSpuSaveResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaMosGoodsOpenSpuSaveRequest;
$param_open_spu_save_dto = new OpenSpuSaveDto;
$param_open_spu_save_dto->allow_adding="true";
$param_open_spu_save_dto->category_id="51101111";
$color_images = new ColorImageVo;
$color_images->image_url="http://sss";
$color_images->pv_id="11111:22222";
$color_images->prop_name="颜色";
$color_images->prop_value="白色";
$param_open_spu_save_dto->color_images = $color_images;
$cspus = new OpenCspuSaveDto;
$cspus->art_no="1111111";
$cspus->barcode="11111";
$cspus->outer_id="111111";
$props = new GoodsPropertyDto;
$props->property_id="1111";
$props->property_name="颜色分类";
$props->property_sort_order="1";
$props->value_custom_name="颜色";
$props->value_id="111";
$props->value_name="红色";
$props->value_sort_order="1";
$cspus->props = $props;
$cspus->tag_price="1000";
$cspus->title="测试";
$param_open_spu_save_dto->cspus = $cspus;
$detail_images = new ImageVo;
$detail_images->height="200";
$detail_images->position="1";
$detail_images->url="url";
$detail_images->width="1000";
$param_open_spu_save_dto->detail_images = $detail_images;
$param_open_spu_save_dto->intime_brand_id="11328";
$main_images = new ImageVo;
$main_images->height="800";
$main_images->position="1";
$main_images->url="url";
$main_images->width="800";
$param_open_spu_save_dto->main_images = $main_images;
$props = new GoodsPropertyDto;
$props->property_id="1111";
$props->property_name="产地";
$props->property_sort_order="1";
$props->value_custom_name="北京";
$props->value_id="1111";
$props->value_name="北京";
$props->value_sort_order="1";
$param_open_spu_save_dto->props = $props;
$param_open_spu_save_dto->short_title="短标题";
$param_open_spu_save_dto->style_no="TM2020212";
$param_open_spu_save_dto->title="测试标题";
$param_open_spu_save_dto->goods_type="NORMAL";
$three_to_four_images = new ImageVO;
$three_to_four_images->height="750";
$three_to_four_images->position="0";
$three_to_four_images->url="url";
$three_to_four_images->width="100";
$param_open_spu_save_dto->three_to_four_images = $three_to_four_images;
$req->setParamOpenSpuSaveDto(json_encode($param_open_spu_save_dto));
$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=alibaba.mos.goods.open.spu.save' \
-d 'partner_id=apidoc' \
-d 'session=636502e5-d58a-493a-b251-a5214f05a7d9' \
-d 'sign=08AEE1F611D32131D401C3447FD680E0' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-06-08+01%3A05%3A25' \
-d 'v=2.0' \
-d 'param_open_spu_save_dto=null'

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

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

req.param_open_spu_save_dto=""
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,"alibaba.mos.goods.open.spu.save");
add_param(pRequest,"param_open_spu_save_dto","数据结构JSON示例");
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('alibaba.mos.goods.open.spu.save', {
	'param_open_spu_save_dto':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_mos_goods_open_spu_save_response>
    <data>
        <cspus>
            <barcode_cspu>
                <barcode>TM111111</barcode>
                <cspu_id>1000200001234</cspu_id>
            </barcode_cspu>
        </cspus>
        <spu_id>1000200001231</spu_id>
    </data>
    <tips_msg>提示</tips_msg>
</alibaba_mos_goods_open_spu_save_response>

{
    "alibaba_mos_goods_open_spu_save_response":{
        "data":{
            "cspus":{
                "barcode_cspu":[
                    {
                        "barcode":"TM111111",
                        "cspu_id":1000200001234
                    }
                ]
            },
            "spu_id":1000200001231
        },
        "tips_msg":"提示"
    }
}

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下载

开放平台

银泰开放平台

alibaba.mos.goods.open.spu.save (数字化(整款)信息录入)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ