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

阿里拍卖发布标的(草稿)新版

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
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());

响应示例

  • 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工具

如何获得此API

FAQ

返回
顶部