taobao.auction.apply.add (同步报名用户)

将标的的用户报名信息同步到阿里拍卖

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
item_id Number 必须 127612 标的id
apply_auction_request_d_o ApplyAuctionRequestDo 必须 同步报名用户入参
  • └ real_name
  • String
  • 必须
  • 张三
  • 用户真实姓名
  • └ paid_money
  • Number
  • 必须
  • 100
  • 用户已缴纳保证金额,单位分
  • └ phone
  • String
  • 必须
  • 18888888888
  • 用户手机号,这个手机号是用户的唯一标识
  • └ card_id
  • String
  • 必须
  • 594011253898883
  • 用户证件号,根据证件类型填对应类型的证件号
  • └ card_type
  • Number
  • 必须
  • 2
  • 证件类型,1=企业营业执照,2=身份证,3=台胞证,4=港澳证件,5=护照,8=组织机构代码证件,9=统一社会信用代码
  • └ contact_address
  • String
  • 必须
  • 浙江省杭州市余杭区阿里巴巴西溪园区A区
  • 用户联系地址
  • └ out_user_id
  • String
  • 可选
  • U_123
  • 用户外部系统用户id,选填。在后续的标的详情、成交查询接口中会透出该字段,用于开发者匹配内部系统的用户
  • └ sign_token
  • String
  • 必须
  • sign_token_123
  • 开发者自行生成,要求单标的下不同用户之间要唯一即可,后面场景会结合手机号和token校验用户报名资格。格式:支持大小写字母/数字/中划线/下划线,长度50字符以内
  • └ user_ip
  • String
  • 必须
  • 192.168.1.1
  • 报名用户ip

响应参数

名称 类型 示例值 描述
result Result4Top 接口出参
  • └ error_code
  • String
  • system-error
  • 错误code
  • value
  • ApplyAuctionResponseDo
  • 同步报名用户返回结果
  • └ alias_name
  • String
  • A1234
  • 用户竞买号
  • └ error_msg
  • String
  • 同步报名用户接口不可用
  • 错误信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AuctionApplyAddRequest req = new AuctionApplyAddRequest();
req.setItemId(127612L);
AuctionApplyAddRequest.ApplyAuctionRequestDo obj1 = new AuctionApplyAddRequest.ApplyAuctionRequestDo();
obj1.setRealName("张三");
obj1.setPaidMoney(100L);
obj1.setPhone("18888888888");
obj1.setCardId("594011253898883");
obj1.setCardType(2L);
obj1.setContactAddress("浙江省杭州市余杭区阿里巴巴西溪园区A区");
obj1.setOutUserId("U_123");
obj1.setSignToken("sign_token_123");
obj1.setUserIp("192.168.1.1");
req.setApplyAuctionRequestDO(obj1);
AuctionApplyAddResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<auction_apply_add_response>
    <result>
        <error_code>system-error</error_code>
        <value>
            <alias_name>A1234</alias_name>
        </value>
        <error_msg>同步报名用户接口不可用</error_msg>
    </result>
</auction_apply_add_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

返回
顶部