淘宝开放平台

请求地址：

环境	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_add_zc_auction_d_o	AddZcAuctionDo	可选			拍品实体对象
└ attach_urls String [] 可选附件的淘宝链接地址附件的淘宝链接地址 └ buyer_nubmer Number 可选 1 默认竞拍成功需要最低参拍人数，默认值:1 ，一般为1或2 └ category_id Number 可选 34342 资产拍品类目id，123576001:土地;123578001:机动车;123580001:机械设备;123582001:知识产权;123584001:无形资产;123582002:其他资产;123584002:债权;123586001:股权;123564002:房产;125074003:加贸边角料;126242006:矿权;126254003:船舶;126332001:工程;126252003:林权;127110002:通信设备;127076005:奢侈品;127080005:农资产品; └ comp Number 可选 132 佣金比例(万分比)，例：123 即1.23% └ consult_price Number 可选 1223 评估价（分） └ description String 可选标的物的描述信息标的物的描述信息,最多100000个字符 └ end Date 可选 2015-12-21 09:20:37 拍品拍卖结束时间（非必填） └ freeze_amount Number 可选 11 保证金金额,大于100（分） └ increase_range Number 可选 123 加价幅度（分） └ is_buy_restrictions Boolean 可选 true 是否限购,false=不限购，默认true └ is_support_loans Boolean 可选 false 是否支持贷款,true=支持贷款，默认false └ item_notice String 可选拍卖须知拍卖须知,最多100000个字符 └ link_man String 可选张三联系人姓名,最多30个字符 └ location Number 可选 122232 标的物所在地坐标 └ mobile_phone String 可选 13534334*** 手机 └ movie_url String 可选淘宝域名下的url地址视频 └ out_id Number 可选 12324 合作伙伴id号，查询时会返回该id,要求唯一,最长64个字符 └ pic_url_list String [] 可选淘宝域名下的url地址拍品的宝贝图片，最少1张，最多5账号，第一张为主图 └ postage Number 可选 0 邮费（分） └ project_id Number 必须 12343 公告id └ proxy_nick String 必须中国联通XXX分公司入驻机构nick(淘宝账号名称)，发布在哪个拍卖入驻机构名下 └ reserve_price Number 可选 213232 保留价（分） └ start Date 可选 2015-12-23 09:20:37 拍品开始时间（非必填） └ start_price Number 可选 1212 起拍价（分） └ title String 可选拍品标题拍品标题,最多50个字符 └ sub_account_nick String 可选子账号nick 子账号nick auction_result_display AuctionResultDisplay 可选竞价结果公示及配置 └ auction_result_display Boolean 可选 true 竞价结果是否公示 └ auction_result_display_condition Number 可选 1 公示条件:0=无条件,1=仅有一人报名 └ auction_result_display_duration Number 可选 12 公示时长，单位天

名称	类型	示例值	描述
op_code	String	无	错误code
op_msg	String	无	错误描述
op_success	Boolean	true	调用成功 true,失败false
value	Number	12323	数字id（非拍品id）

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AuctionZcAuctionPublicRequest req = new AuctionZcAuctionPublicRequest();
AuctionZcAuctionPublicRequest.AddZcAuctionDo obj1 = new AuctionZcAuctionPublicRequest.AddZcAuctionDo();
obj1.setAttachUrls("附件的淘宝链接地址");
obj1.setBuyerNubmer(1L);
obj1.setCategoryId(34342L);
obj1.setComp(132L);
obj1.setConsultPrice(1223L);
obj1.setDescription("标的物的描述信息");
obj1.setEnd(StringUtils.parseDateTime("2015-12-21 09:20:37"));
obj1.setFreezeAmount(11L);
obj1.setIncreaseRange(123L);
obj1.setIsBuyRestrictions(true);
obj1.setIsSupportLoans(false);
obj1.setItemNotice("拍卖须知");
obj1.setLinkMan("张三");
obj1.setLocation(122232L);
obj1.setMobilePhone("13534334***");
obj1.setMovieUrl("淘宝域名下的url地址");
obj1.setOutId(12324L);
obj1.setPicUrlList("淘宝域名下的url地址");
obj1.setPostage(0L);
obj1.setProjectId(12343L);
obj1.setProxyNick("中国联通XXX分公司");
obj1.setReservePrice(213232L);
obj1.setStart(StringUtils.parseDateTime("2015-12-23 09:20:37"));
obj1.setStartPrice(1212L);
obj1.setTitle("拍品标题");
obj1.setSubAccountNick("子账号nick");
AuctionZcAuctionPublicRequest.AuctionResultDisplay obj2 = new AuctionZcAuctionPublicRequest.AuctionResultDisplay();
obj2.setAuctionResultDisplay(true);
obj2.setAuctionResultDisplayCondition(1L);
obj2.setAuctionResultDisplayDuration(12L);
obj1.setAuctionResultDisplay(obj2);
req.setParamAddZcAuctionDO(obj1);
AuctionZcAuctionPublicResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AuctionZcAuctionPublicRequest;
$param_add_zc_auction_d_o = new AddZcAuctionDo;
$param_add_zc_auction_d_o->attach_urls="附件的淘宝链接地址";
$param_add_zc_auction_d_o->buyer_nubmer="1";
$param_add_zc_auction_d_o->category_id="34342";
$param_add_zc_auction_d_o->comp="132";
$param_add_zc_auction_d_o->consult_price="1223";
$param_add_zc_auction_d_o->description="标的物的描述信息";
$param_add_zc_auction_d_o->end="2015-12-21 09:20:37";
$param_add_zc_auction_d_o->freeze_amount="11";
$param_add_zc_auction_d_o->increase_range="123";
$param_add_zc_auction_d_o->is_buy_restrictions="true";
$param_add_zc_auction_d_o->is_support_loans="false";
$param_add_zc_auction_d_o->item_notice="拍卖须知";
$param_add_zc_auction_d_o->link_man="张三";
$param_add_zc_auction_d_o->location="122232";
$param_add_zc_auction_d_o->mobile_phone="13534334***";
$param_add_zc_auction_d_o->movie_url="淘宝域名下的url地址";
$param_add_zc_auction_d_o->out_id="12324";
$param_add_zc_auction_d_o->pic_url_list="淘宝域名下的url地址";
$param_add_zc_auction_d_o->postage="0";
$param_add_zc_auction_d_o->project_id="12343";
$param_add_zc_auction_d_o->proxy_nick="中国联通XXX分公司";
$param_add_zc_auction_d_o->reserve_price="213232";
$param_add_zc_auction_d_o->start="2015-12-23 09:20:37";
$param_add_zc_auction_d_o->start_price="1212";
$param_add_zc_auction_d_o->title="拍品标题";
$param_add_zc_auction_d_o->sub_account_nick="子账号nick";
$auction_result_display = new AuctionResultDisplay;
$auction_result_display->auction_result_display="true";
$auction_result_display->auction_result_display_condition="1";
$auction_result_display->auction_result_display_duration="12";
$param_add_zc_auction_d_o->auction_result_display = $auction_result_display;
$req->setParamAddZcAuctionDO(json_encode($param_add_zc_auction_d_o));
$resp = $c->execute($req);

XML示例
JSON示例

<auction_zc_auction_public_response>
    <op_code>无</op_code>
    <op_msg>无</op_msg>
    <op_success>true</op_success>
    <value>12323</value>
</auction_zc_auction_public_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.unauthorized_api_access	没有当前API的访问权限	联系产品或者运营同学，重新配置开发者isv 当前API的访问权限
isv.unauthorized_appkey	未经授权的的appKey，isv开发者没有权限访问开放平台拍卖大资产API接口	联系阿里拍卖产品或者运营人员进行授权访问
isv.unauthorized_temp_auction_publish_with_current_project_id	公告ID不合法或者是该公告ID对应创建者与当前草稿拍品发布者不一致	请检查填写的公告ID是否正确，或者检查下当前输入参数proxyNick（机构nick）是否仍有创建公告的权限
isv.proxy_nick_not_found	找不到发拍机构nick,请输入合法的发拍机构nick	检查输入参数proxyNick（机构nick）是否是一个有效的淘宝账号，
isv.sub_account_nick_not_found	找不到子账号，请输入合法的子账号	检查输入参数subAccountNick（机构子账号）是否是一个有效的淘宝账号
isv.unauthorized_proxy_nick_access	没有该公告或者拍品对应发拍机构的授权	检查当前isv开发者账号是否有获取对应proxyNick（机构nick）拍品发布的授权，请联系阿里拍卖产品或者运营同学进行授权配置。

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

拍卖API

taobao.auction.zc.auction.public (阿里拍卖发布标的（草稿）新版)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ