淘宝开放平台

请求地址：

环境	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 [] 可选 TB1FSY6XXXXXXX2XFXX.LpbFXXX 附件的淘宝链接地址 └ buyer_nubmer Number 可选 1 默认竞拍成功需要最低参拍人数 └ category_id Number 可选 133422695 淘宝类目id └ comp Number 可选 132 佣金比例(万分比)，例：123 即1.23% └ consult_price Number 可选 88800 评估价（单位：分） └ description String 可选 98新宝马X3 标的物的描述信息 └ end Date 可选 2017-02-21 09:20:37 拍品拍卖结束时间（非必填） └ freeze_amount Number 可选 2000 保证金金额,大于100（单位：分） └ increase_range Number 可选 1000 加价幅度（单位：分） └ is_buy_restrictions Boolean 可选 true 是否限购,false=不限购，默认true └ is_support_loans Boolean 可选 false 是否支持贷款,true=支持贷款，默认false └ item_notice String 可选拍卖须知拍卖须知 └ link_man String 可选张三联系人姓名 └ location Number 可选 120226 标的物所在地坐标 └ mobile_phone String 可选 13534334*** 手机 └ movie_url String 可选 http://www.taobao.com 视频地址 └ out_id Number 可选 12324 合作伙伴id号，查询时会返回该id,要求唯一 └ pic_url_list String [] 可选 i3/65753801/TB2gi0aXXXXXXalXXXXXXXXXXXX_!!65753801-0-paimai.jpg 拍品的宝贝图片，最少1张，最多5账号，第一张为主图 └ postage Number 可选 0 邮费（单位：分） └ project_id Number 必须 135068 公告id └ proxy_nick String 可选中国联通XXX分公司入驻机构nick(淘宝账号名称)，发布在哪个拍卖入驻机构名下 └ reserve_price Number 可选 1000 保留价（单位：分） └ start Date 可选 2017-01-23 09:20:37 拍品开始时间 └ start_price Number 可选 10000 起拍价（单位：分） └ title String 可选宝马X3拍卖拍品标题 └ auction_biz_type Number 可选 2 资产类型.1-国有资产,2-民营（个人）资产 └ delivery_mode Number 可选 0 0-未指定;1-自提;2-到付;3-邮寄(通过postage字段指定邮费) └ 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

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AuctionZcAuctionDraftPublicRequest req = new AuctionZcAuctionDraftPublicRequest();
AuctionZcAuctionDraftPublicRequest.AddZcAuctionDo obj1 = new AuctionZcAuctionDraftPublicRequest.AddZcAuctionDo();
obj1.setAttachUrls("TB1FSY6XXXXXXX2XFXX.LpbFXXX");
obj1.setBuyerNubmer(1L);
obj1.setCategoryId(133422695L);
obj1.setComp(132L);
obj1.setConsultPrice(88800L);
obj1.setDescription("98新宝马X3");
obj1.setEnd(StringUtils.parseDateTime("2017-02-21 09:20:37"));
obj1.setFreezeAmount(2000L);
obj1.setIncreaseRange(1000L);
obj1.setIsBuyRestrictions(true);
obj1.setIsSupportLoans(false);
obj1.setItemNotice("拍卖须知");
obj1.setLinkMan("张三");
obj1.setLocation(120226L);
obj1.setMobilePhone("13534334***");
obj1.setMovieUrl("http://www.taobao.com");
obj1.setOutId(12324L);
obj1.setPicUrlList("i3/65753801/TB2gi0aXXXXXXalXXXXXXXXXXXX_!!65753801-0-paimai.jpg");
obj1.setPostage(0L);
obj1.setProjectId(135068L);
obj1.setProxyNick("中国联通XXX分公司");
obj1.setReservePrice(1000L);
obj1.setStart(StringUtils.parseDateTime("2017-01-23 09:20:37"));
obj1.setStartPrice(10000L);
obj1.setTitle("宝马X3拍卖");
obj1.setAuctionBizType(2L);
obj1.setDeliveryMode(0L);
obj1.setSubAccountNick("子账号nick");
AuctionZcAuctionDraftPublicRequest.AuctionResultDisplay obj2 = new AuctionZcAuctionDraftPublicRequest.AuctionResultDisplay();
obj2.setAuctionResultDisplay(true);
obj2.setAuctionResultDisplayCondition(1L);
obj2.setAuctionResultDisplayDuration(12L);
obj1.setAuctionResultDisplay(obj2);
req.setParamAddZcAuctionDO(obj1);
AuctionZcAuctionDraftPublicResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AuctionZcAuctionDraftPublicRequest;
$param_add_zc_auction_d_o = new AddZcAuctionDo;
$param_add_zc_auction_d_o->attach_urls="TB1FSY6XXXXXXX2XFXX.LpbFXXX";
$param_add_zc_auction_d_o->buyer_nubmer="1";
$param_add_zc_auction_d_o->category_id="133422695";
$param_add_zc_auction_d_o->comp="132";
$param_add_zc_auction_d_o->consult_price="88800";
$param_add_zc_auction_d_o->description="98新宝马X3";
$param_add_zc_auction_d_o->end="2017-02-21 09:20:37";
$param_add_zc_auction_d_o->freeze_amount="2000";
$param_add_zc_auction_d_o->increase_range="1000";
$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="120226";
$param_add_zc_auction_d_o->mobile_phone="13534334***";
$param_add_zc_auction_d_o->movie_url="http://www.taobao.com";
$param_add_zc_auction_d_o->out_id="12324";
$param_add_zc_auction_d_o->pic_url_list="i3/65753801/TB2gi0aXXXXXXalXXXXXXXXXXXX_!!65753801-0-paimai.jpg";
$param_add_zc_auction_d_o->postage="0";
$param_add_zc_auction_d_o->project_id="135068";
$param_add_zc_auction_d_o->proxy_nick="中国联通XXX分公司";
$param_add_zc_auction_d_o->reserve_price="1000";
$param_add_zc_auction_d_o->start="2017-01-23 09:20:37";
$param_add_zc_auction_d_o->start_price="10000";
$param_add_zc_auction_d_o->title="宝马X3拍卖";
$param_add_zc_auction_d_o->auction_biz_type="2";
$param_add_zc_auction_d_o->delivery_mode="0";
$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_draft_public_response>
    <op_code>无</op_code>
    <op_msg>无</op_msg>
    <op_success>true</op_success>
    <value>12323</value>
</auction_zc_auction_draft_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>

错误码	错误描述	解决方案

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

拍卖API

taobao.auction.zc.auction.draft.public (阿里拍卖发布标的（草稿）老版即将下线)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ