淘宝开放平台 - 文档中心

请求地址：

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

名称	类型	是否必须	示例值	描述
proxy_nick	String	必须	tiangu3	替哪个用户发布招商公告，如果是自己给自己发布，这里填自己的淘宝帐号（长度[4, 20]）
merchant_notice	MerchantNotice	必须		招商公告对象
attachments Attachment [] 可选附件,单个文件最大不超过3M，文件数量最多不超过5个 └ local_file_name String 可选文件1 文件名（最大长度100） └ url String 可选 SDW232XXXX_WE! 文件地址, 使用taobao.auction.gov.publish.upload.attachfile附件上传接口拿到附件key后使用，不支持非阿里文件地址（最大长度200） contacts Contact [] 必须联系人（最多5个） └ name String 必须张三姓名（建议最大长度不超过50） └ phone String 必须 13888888888 联系电话 └ detail String 可选 ... 公告详情（最大长度100000） └ location_code Number 必须 330100 所在地区域码参见taobao.auction.gov.get.division └ lower_price Number 可选 10 参考价值下限单位元 └ merchant_notice_id Number 可选 6688 招商公告ID └ pic_urls String [] 必须 ["https://img.alicdn.com/bao/uploaded/i1/3258232187/TB2CobIpSFjpuFjSszhXXaBuVXa_!!0-paimai.jpg_300x300"] 图片地址,使用taobao.auction.gov.publish.upload.pic上传图片拿到url后使用，不支持非阿里图片地址(图片最多5张，单张不超过5M) └ summary String 可选 ... 招商公告摘要（最大长度150） └ title String 必须关于xxx的招商公告招商公告标题（最大长度50） └ type Number 必须 123584002 招商公告类型: 土地-123576001,机动车-123578001,机械设备-123580001,知识产权-123582001,无形资产-123584001,其他资产-123582002,债权-123584002,股权-123586001,房产-123564002,加贸边角料-125074003,矿权-126242006,船舶-126254003,工程-126332001,林权-126252003,通信设备-127110002,奢侈品-127076005,农资产品-127080005,3C数码-201274575,生产物资-201858302,经营权-201869002,科技成果-202051915 └ upper_price Number 可选 1000000 参考价值上限单位元 type_extra TypeExtra 可选类型下的附加字段。务必查看：http://open.taobao.com/docs/doc.htm?spm=a219a.7629140.0.0.4gyX1l&treeId=417&articleId=107140&docType=1 debt_right_extra DebtRightExtra 可选债权类型下的附加字段,如果type=债权，本项必填，查看：http://open.taobao.com/docs/doc.htm?spm=a219a.7629140.0.0.4gyX1l&treeId=417&articleId=107140&docType=1 guarantors Guarantor [] 可选保证人 └ name String 可选王五保证人姓名（最大长度200） └ desc String 可选王五保证... 描述（最大长度1000） └ guarant_types String [] 可选 [1,2] 保证类型1-保证 2-抵（质）押+保证 3-抵（质）押 4-信用 └ debt_right_principal String 可选 100 债权本金:单位万元,必填（最大不超过1000亿） └ debt_right_interest String 可选 1 债权利息:单位万元（最大不超过1000亿） └ debt_right_base_date Date 可选 2017-01-01 00:00:00 债权基准日 debtor Debtor 可选债务人 └ name String 可选李四债务人名称（最大长度200） └ desc String 可选李四... 描述（最大长度1000） └ litigation_no String 可选（2022）浙执001号执行案号/诉讼案号（建议长度最大不超过50） └ other_fee String 可选 2 其他费用:单位万元（最大不超过1000亿） └ asset_package Boolean 可选 true 债权形态是否是债权包 true：债权包 false：单笔债权空：未知 └ property_type Number 必须 1 1-国有资产; 2-普通资产; 4-涉案资产; 5-涉公资产; 6-诉讼资产; 7-金融资产; 8-破产资产 └ multi_currency Boolean 可选 true 是否包含多币种 true 包含 false 不包含，非必填 └ recruit_end_time String 可选 2023-09-10 招募截止日期，格式为yyyy-MM-dd, 最多不允许超过180天，不填或填写超过180天，按默认180天算 └ enterprise_name String 可选 xxxx破产公司破产企业名称（项目类型property_type=8时，填写内容生效，建议长度最大不超过50） └ industry_sort_code String 可选 A011 行业分类code，完整三级code，例如A011(项目类型property_type=8时，填写内容生效) └ bankrupt_stage Number 可选 1 破产程序, 0清算, 1重整, 2 和解, 3重整投资招募,4 个人债务集中清理（项目类型property_type=8时，填写内容生效） └ out_id String 可选 MN11 外部唯一id（会进行防重复创建校验，建议长度最大不超过64）

名称	类型	示例值	描述
result_code	String	success	errorCode
result_msg	String	操作成功	errorMsg
value	Number	6688	招商公告ID

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AuctionZcMerchantnoticeUpdateRequest req = new AuctionZcMerchantnoticeUpdateRequest();
req.setProxyNick("tiangu3");
AuctionZcMerchantnoticeUpdateRequest.MerchantNotice obj1 = new AuctionZcMerchantnoticeUpdateRequest.MerchantNotice();
List<AuctionZcMerchantnoticeUpdateRequest.Attachment> list3 = new ArrayList<AuctionZcMerchantnoticeUpdateRequest.Attachment>();
AuctionZcMerchantnoticeUpdateRequest.Attachment obj4 = new AuctionZcMerchantnoticeUpdateRequest.Attachment();
list3.add(obj4);
obj4.setLocalFileName("文件1");
obj4.setUrl("SDW232XXXX_WE!");
obj1.setAttachments(list3);
List<AuctionZcMerchantnoticeUpdateRequest.Contact> list6 = new ArrayList<AuctionZcMerchantnoticeUpdateRequest.Contact>();
AuctionZcMerchantnoticeUpdateRequest.Contact obj7 = new AuctionZcMerchantnoticeUpdateRequest.Contact();
list6.add(obj7);
obj7.setName("张三");
obj7.setPhone("13888888888");
obj1.setContacts(list6);
obj1.setDetail("...");
obj1.setLocationCode(330100L);
obj1.setLowerPrice(10L);
obj1.setMerchantNoticeId(6688L);
obj1.setPicUrls(""https://img.alicdn.com/bao/uploaded/i1/3258232187/TB2CobIpSFjpuFjSszhXXaBuVXa_!!0-paimai.jpg_300x300"");
obj1.setSummary("...");
obj1.setTitle("关于xxx的招商公告");
obj1.setType(123584002L);
obj1.setUpperPrice(1000000L);
AuctionZcMerchantnoticeUpdateRequest.TypeExtra obj8 = new AuctionZcMerchantnoticeUpdateRequest.TypeExtra();
AuctionZcMerchantnoticeUpdateRequest.DebtRightExtra obj9 = new AuctionZcMerchantnoticeUpdateRequest.DebtRightExtra();
List<AuctionZcMerchantnoticeUpdateRequest.Guarantor> list11 = new ArrayList<AuctionZcMerchantnoticeUpdateRequest.Guarantor>();
AuctionZcMerchantnoticeUpdateRequest.Guarantor obj12 = new AuctionZcMerchantnoticeUpdateRequest.Guarantor();
list11.add(obj12);
obj12.setName("王五");
obj12.setDesc("王五保证...");
obj9.setGuarantors(list11);
obj9.setGuarantTypes("1,2");
obj9.setDebtRightPrincipal("100");
obj9.setDebtRightInterest("1");
obj9.setDebtRightBaseDate(StringUtils.parseDateTime("2017-01-01 00:00:00"));
AuctionZcMerchantnoticeUpdateRequest.Debtor obj13 = new AuctionZcMerchantnoticeUpdateRequest.Debtor();
obj13.setName("李四");
obj13.setDesc("李四...");
obj9.setDebtor(obj13);
obj9.setLitigationNo("（2022）浙执001号");
obj9.setOtherFee("2");
obj9.setAssetPackage(true);
obj8.setDebtRightExtra(obj9);
obj1.setTypeExtra(obj8);
obj1.setPropertyType(1L);
obj1.setMultiCurrency(true);
obj1.setRecruitEndTime("2023-09-10");
obj1.setEnterpriseName("xxxx破产公司");
obj1.setIndustrySortCode("A011");
obj1.setBankruptStage(1L);
obj1.setOutId("MN11");
req.setMerchantNotice(obj1);
AuctionZcMerchantnoticeUpdateResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AuctionZcMerchantnoticeUpdateRequest req = new AuctionZcMerchantnoticeUpdateRequest();
req.ProxyNick = "tiangu3";
AuctionZcMerchantnoticeUpdateRequest.MerchantNoticeDomain obj1 = new AuctionZcMerchantnoticeUpdateRequest.MerchantNoticeDomain();
List<AuctionZcMerchantnoticeUpdateRequest.AttachmentDomain> list3 = new List<AuctionZcMerchantnoticeUpdateRequest.AttachmentDomain>();
AuctionZcMerchantnoticeUpdateRequest.AttachmentDomain obj4 = new AuctionZcMerchantnoticeUpdateRequest.AttachmentDomain();
list3.Add(obj4);
obj4.LocalFileName = "文件1";
obj4.Url = "SDW232XXXX_WE!";
obj1.Attachments= list3;
List<AuctionZcMerchantnoticeUpdateRequest.ContactDomain> list6 = new List<AuctionZcMerchantnoticeUpdateRequest.ContactDomain>();
AuctionZcMerchantnoticeUpdateRequest.ContactDomain obj7 = new AuctionZcMerchantnoticeUpdateRequest.ContactDomain();
list6.Add(obj7);
obj7.Name = "张三";
obj7.Phone = "13888888888";
obj1.Contacts= list6;
obj1.Detail = "...";
obj1.LocationCode = 330100L;
obj1.LowerPrice = 10L;
obj1.MerchantNoticeId = 6688L;
obj1.PicUrls = ""https://img.alicdn.com/bao/uploaded/i1/3258232187/TB2CobIpSFjpuFjSszhXXaBuVXa_!!0-paimai.jpg_300x300"";
obj1.Summary = "...";
obj1.Title = "关于xxx的招商公告";
obj1.Type = 123584002L;
obj1.UpperPrice = 1000000L;
AuctionZcMerchantnoticeUpdateRequest.TypeExtraDomain obj8 = new AuctionZcMerchantnoticeUpdateRequest.TypeExtraDomain();
AuctionZcMerchantnoticeUpdateRequest.DebtRightExtraDomain obj9 = new AuctionZcMerchantnoticeUpdateRequest.DebtRightExtraDomain();
List<AuctionZcMerchantnoticeUpdateRequest.GuarantorDomain> list11 = new List<AuctionZcMerchantnoticeUpdateRequest.GuarantorDomain>();
AuctionZcMerchantnoticeUpdateRequest.GuarantorDomain obj12 = new AuctionZcMerchantnoticeUpdateRequest.GuarantorDomain();
list11.Add(obj12);
obj12.Name = "王五";
obj12.Desc = "王五保证...";
obj9.Guarantors= list11;
obj9.GuarantTypes = "1,2";
obj9.DebtRightPrincipal = "100";
obj9.DebtRightInterest = "1";
obj9.DebtRightBaseDate = DateTime.Parse(2017-01-01 00:00:00");
AuctionZcMerchantnoticeUpdateRequest.DebtorDomain obj13 = new AuctionZcMerchantnoticeUpdateRequest.DebtorDomain();
obj13.Name = "李四";
obj13.Desc = "李四...";
obj9.Debtor= obj13;
obj9.LitigationNo = "（2022）浙执001号";
obj9.OtherFee = "2";
obj9.AssetPackage = true;
obj8.DebtRightExtra= obj9;
obj1.TypeExtra= obj8;
obj1.PropertyType = 1L;
obj1.MultiCurrency = true;
obj1.RecruitEndTime = "2023-09-10";
obj1.EnterpriseName = "xxxx破产公司";
obj1.IndustrySortCode = "A011";
obj1.BankruptStage = 1L;
obj1.OutId = "MN11";
req.MerchantNotice_ = obj1;
AuctionZcMerchantnoticeUpdateResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AuctionZcMerchantnoticeUpdateRequest;
$req->setProxyNick("tiangu3");
$merchant_notice = new MerchantNotice;
$attachments = new Attachment;
$attachments->local_file_name="文件1";
$attachments->url="SDW232XXXX_WE!";
$merchant_notice->attachments = $attachments;
$contacts = new Contact;
$contacts->name="张三";
$contacts->phone="13888888888";
$merchant_notice->contacts = $contacts;
$merchant_notice->detail="...";
$merchant_notice->location_code="330100";
$merchant_notice->lower_price="10";
$merchant_notice->merchant_notice_id="6688";
$merchant_notice->pic_urls="[\"https://img.alicdn.com/bao/uploaded/i1/3258232187/TB2CobIpSFjpuFjSszhXXaBuVXa_!!0-paimai.jpg_300x300\"]";
$merchant_notice->summary="...";
$merchant_notice->title="关于xxx的招商公告";
$merchant_notice->type="123584002";
$merchant_notice->upper_price="1000000";
$type_extra = new TypeExtra;
$debt_right_extra = new DebtRightExtra;
$guarantors = new Guarantor;
$guarantors->name="王五";
$guarantors->desc="王五保证...";
$debt_right_extra->guarantors = $guarantors;
$debt_right_extra->guarant_types="[1,2]";
$debt_right_extra->debt_right_principal="100";
$debt_right_extra->debt_right_interest="1";
$debt_right_extra->debt_right_base_date="2017-01-01 00:00:00";
$debtor = new Debtor;
$debtor->name="李四";
$debtor->desc="李四...";
$debt_right_extra->debtor = $debtor;
$debt_right_extra->litigation_no="（2022）浙执001号";
$debt_right_extra->other_fee="2";
$debt_right_extra->asset_package="true";
$type_extra->debt_right_extra = $debt_right_extra;
$merchant_notice->type_extra = $type_extra;
$merchant_notice->property_type="1";
$merchant_notice->multi_currency="true";
$merchant_notice->recruit_end_time="2023-09-10";
$merchant_notice->enterprise_name="xxxx破产公司";
$merchant_notice->industry_sort_code="A011";
$merchant_notice->bankrupt_stage="1";
$merchant_notice->out_id="MN11";
$req->setMerchantNotice(json_encode($merchant_notice));
$resp = $c->execute($req);

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=taobao.auction.zc.merchantnotice.update' \
-d 'partner_id=apidoc' \
-d 'sign=D8E277B333FD1D50843C4C0C8BBB2B15' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-05-04+00%3A48%3A10' \
-d 'v=2.0' \
-d 'merchant_notice=null' \
-d 'proxy_nick=tiangu3'

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

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

req.proxy_nick="tiangu3"
req.merchant_notice=""
try:
	resp= req.getResponse()
	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.auction.zc.merchantnotice.update");
add_param(pRequest,"proxy_nick","tiangu3");
add_param(pRequest,"merchant_notice","数据结构JSON示例");
pResponse = top_execute(pClient,pRequest,NULL);
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.auction.zc.merchantnotice.update', {
	'proxy_nick':'tiangu3',
	'merchant_notice':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<auction_zc_merchantnotice_update_response>
    <result_code>success</result_code>
    <result_msg>操作成功</result_msg>
    <value>6688</value>
</auction_zc_merchantnotice_update_response>

{
    "auction_zc_merchantnotice_update_response":{
        "result_code":"success",
        "result_msg":"操作成功",
        "value":6688
    }
}

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"
	}
}

错误码	错误描述	解决方案
isp.success	操作成功	无
isp.unknown_exception	未知异常	联系拍卖开发人员解决
isp.appkey_not_specify	appkey未指定	检查是否传递appkey参数
isp.proxynick_not_specify	代理用户未指定	检查是否设置proxy_nick参数
isp.proxynick_not_found	代理用户不存在	检查proxy_nick是否合理
isp.proxy_relation_not_found	代理关系不存在	提供appkey和proxy_nick让拍卖开发人员添加代理关系
isp.param_not_specify	参数未指定	检查merchant_notice参数是否指定
isp.merchant_notice_not_found	未找到招商公告	检查merchant_notice_id对应的招商公告是否存在
isp.merchant_notice_is_illegal	非法的招商公告	联系拍卖开发人员解决
isp.merchant_notice_cannot_access	无权访问招商公告	检查招商公告是否为proxy_nick拥有
isp.merchant_notice_illegal_status	招商公告状态不合法	检查招商公告状态是否为编辑中或者招商中，其它状态不允许编辑
isp.query_merchant_notice_failed	查询招商公告失败	联系拍卖开发人员解决
isp.title_not_specify	标题未指定	检查title参数是否设置
isp.title_exceed_length	标题超长	检查标题是否在50字以内
isp.type_not_specify	资产类型未指定	检查type参数是否设置
isp.type_is_illegal	非法的资产类型	检查type是否为文档中提到的类型
isp.locationcode_not_specify	区域码未指定	检查location_code参数是否设置
isp.locationcode_is_illegal	非法的区域码	检查区域码是否合法，是否taobao.auction.gov.get.division接口返回的区域码
isp.contact_not_specify	联系人未指定	检查contacts参数是否设置
isp.contact_too_many	联系人过多	检查联系人数组长度，最多为5
isp.pic_too_many	图片过多	检查图片数组长度，最多为5
isp.summary_not_specify	摘要未指定	检查summary参数是否设置
isp.summary_exceed_length	摘要超长	检查summary是否150字以内
isp.attach_too_many	附件过多	检查attachments数组大小，最多为5
isp.referprice_is_illegal	参考价格不合法	检查lower_price和upper_price是否合法
isp.guarantor_exceed_length	保证人内容过长	检查保证人内容是否1000字以内
isp.guaranttype_not_specify	保证类型未指定	检查guarant_type参数是否设置
isp.guaranttype_is_illegal	保证类型不合法	检查guarant_type是否文档中描述
isp.principal_not_specify	债权本金未指定	检查debt_right_principal参数是否设置
isp.interest_not_specify	债权本息未指定	检查debt_right_interest参数是否设置
isp.basedate_not_specify	债权基准日未指定	检查debt_right_base_date参数是否设置
isp.basedate_is_illegal	债权基准日不合法	检查年份是否在1900到2200之间
isp.debtor_name_not_specify	债权人姓名未指定	检查debtor name参数是否设置
isp.debtor_name_exceed_length	债权人姓名超长	检查debtor name是否100字以内
isp.debtor_desc_exceed_length	债权人情况超长	检查debtor desc 是否1000字以内
isp.add_or_update_merchant_notice_failed	更新招商公告失败	联系拍卖开发人员解决
isp.publish_merchant_notice_failed	发布招商公告失败	联系拍卖开发人员解决

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

开放平台

拍卖API

taobao.auction.zc.merchantnotice.update (添加或者更新招商公告)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ