taobao.paimai.auction.create (创建拍卖商品)

创建一个拍卖商品

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param0 CreateRequest 可选 请求参数
  • └ increment
  • Number
  • 必须
  • 1
  • 增价(降价)幅度,单位元
  • └ prov
  • String
  • 必须
  • 浙江
  • └ desc
  • String
  • 必须
  • 这是商品描述
  • 商品描述,html格式
  • └ ceil_price
  • Number
  • 可选
  • 20
  • 增价拍封顶价,不设置表示无封顶价
  • └ category_id
  • Number
  • 必须
  • 50069759
  • 商品类目
  • └ delay_in_minutes
  • Number
  • 可选
  • 5
  • 默认值:5
  • 增价拍出价延迟时间,为0则表示不延迟,默认为5
  • └ image
  • byte[]
  • 可选
  • [1,2,3]
  • 主图字节数组,最大可以上传5M,与pic_urls字段只需设置一个
  • └ foregift
  • Number
  • 必须
  • 5
  • 保证金金额(元)
  • └ properties
  • String
  • 可选
  • 33230:112994;
  • 商品属性
  • └ end_time
  • Date
  • 必须
  • 2018-07-12 20:00:00
  • 拍卖结束时间
  • └ type
  • Number
  • 必须
  • 1
  • 增价拍为1,降价拍为2
  • └ start_price
  • Number
  • 必须
  • 10
  • 拍品起拍价
  • └ city
  • String
  • 必须
  • 杭州
  • 城市
  • └ floor_price
  • Number
  • 可选
  • 5
  • 降价拍专用,表示底价
  • └ start_time
  • Date
  • 必须
  • 2018-07-12 10:00:00
  • 拍卖开始时间
  • └ title
  • String
  • 必须
  • 商品标题
  • 商品标题
  • └ stuff_status
  • Number
  • 必须
  • 5
  • 商品新旧程度:5:全新,6:二手,8:闲置
  • └ quantity
  • Number
  • 可选
  • 1
  • 默认值:1
  • 拍品数量,增价拍必须为1,降价拍为1~10000
  • └ repeat_times
  • Number
  • 可选
  • 1
  • 默认值:0
  • 重复上拍次数,默认为0,0表示不自动重新上架
  • └ pic_urls
  • String []
  • 可选
  • ["i1/2031574726/TB2WxFaXXXXXXalXXXXXXXXXXXX_!!2031574726-2-paimai.png"]
  • 商品图片数组,第一张图片会被设置为主图,最多五张图片,与image只需设置其中一个即可
  • └ status
  • Number
  • 可选
  • 1
  • 默认值:1
  • 上架为1,放入仓库为2
  • └ input_pids
  • String
  • 可选
  • 2432,5353,656425
  • 用户自行输入的类目属性ID串。结构:"pid1,pid2,pid3",如:"20000"(表示品牌) 注:通常一个类目下用户可输入的关键属性不超过1个。
  • └ postage_id
  • Number
  • 可选
  • 32
  • 默认值:0
  • 宝贝所属的运费模板ID,不填写标识使用运费模板
  • └ freight_payer
  • String
  • 可选
  • seller
  • 默认值:seller
  • 运费承担方式,seller(卖家承担),buyer(买家承担)默认为卖家承担
  • └ input_str
  • String
  • 可选
  • 耐克;耐克系列;科比系列;科比系列;2K5
  • 用户自行输入的子属性名和属性值,结构:"父属性值;一级子属性名;一级子属性值;二级子属性名;自定义输入值,....",如:“耐克;耐克系列;科比系列;科比系列;2K5”,input_str需要与input_pids一一对应,注:通常一个类目下用户可输入的关键属性不超过1个。所有属性别名加起来不能超过 3999字节。
  • └ support7day
  • Boolean
  • 可选
  • true
  • 默认值:true
  • 是否支持7天无理由

响应参数

名称 类型 示例值 描述
data Number 生成的商品ID 12345

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
PaimaiAuctionCreateRequest req = new PaimaiAuctionCreateRequest();
PaimaiAuctionCreateRequest.CreateRequest obj1 = new PaimaiAuctionCreateRequest.CreateRequest();
obj1.setIncrement(1L);
obj1.setProv("浙江");
obj1.setDesc("这是商品描述");
obj1.setCeilPrice(20L);
obj1.setCategoryId(50069759L);
obj1.setDelayInMinutes(5L);
obj1.setImage(new FileItem("/tmp/file.txt"));
obj1.setForegift(5L);
obj1.setProperties("33230:112994;");
obj1.setEndTime(StringUtils.parseDateTime("2018-07-12 20:00:00"));
obj1.setType(1L);
obj1.setStartPrice(10L);
obj1.setCity("杭州");
obj1.setFloorPrice(5L);
obj1.setStartTime(StringUtils.parseDateTime("2018-07-12 10:00:00"));
obj1.setTitle("商品标题");
obj1.setStuffStatus(5L);
obj1.setQuantity(1L);
obj1.setRepeatTimes(1L);
obj1.setPicUrls(""i1/2031574726/TB2WxFaXXXXXXalXXXXXXXXXXXX_!!2031574726-2-paimai.png"");
obj1.setStatus(1L);
obj1.setInputPids("2432,5353,656425");
obj1.setPostageId(32L);
obj1.setFreightPayer("seller");
obj1.setInputStr("耐克;耐克系列;科比系列;科比系列;2K5");
obj1.setSupport7day(true);
req.setParam0(obj1);
PaimaiAuctionCreateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<paimai_auction_create_response>
    <data>生成的商品ID</data>
</paimai_auction_create_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工具

如何获得此API

FAQ

返回
顶部