Tradera.com logotype

Tradera Developer Program

BuyerService

Documentation Version 3 > BuyerService > Bid

Bid |WebMethod|

Places a bid on an auction.

Parameters
  1. itemId, The id of an auction.
  2. bidAmount, The bid amount.
Returns

The BidResult object that contains information about the bid. For more information see BidResult

SOAP 1.1

The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /v3/buyerservice.asmx HTTP/1.1
Host: api.tradera.com
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://api.tradera.com/Bid"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Header>
    <AuthenticationHeader xmlns="http://api.tradera.com">
      <AppId>int</AppId>
      <AppKey>string</AppKey>
    </AuthenticationHeader>
    <AuthorizationHeader xmlns="http://api.tradera.com">
      <UserId>int</UserId>
      <Token>string</Token>
    </AuthorizationHeader>
    <ConfigurationHeader xmlns="http://api.tradera.com">
      <Sandbox>int</Sandbox>
      <MaxResultAge>int</MaxResultAge>
    </ConfigurationHeader>
  </soap:Header>
  <soap:Body>
    <Bid xmlns="http://api.tradera.com">
      <itemId>int</itemId>
      <bidAmount>int</bidAmount>
    </Bid>
  </soap:Body>
</soap:Envelope>
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <BidResponse xmlns="http://api.tradera.com">
      <BidResult>
        <Status>LeadingBidder or HigherBidderExists or NotAllowed or BelowMinimum or Ended or UnexpectedError or NotStarted or RegionNotAccepted or OwnItem or ItemNotFound or NumberOfBidsLimitReached or BelowReservePrice or BidNotAvailableOnItem or ChangedMaxBid</Status>
        <LeadingBidder>
          <Id>int</Id>
          <Alias>string</Alias>
          <TotalRating>int</TotalRating>
        </LeadingBidder>
        <LeadingBid>int</LeadingBid>
        <NextBid>int</NextBid>
      </BidResult>
    </BidResponse>
  </soap:Body>
</soap:Envelope>

SOAP 1.2

The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.

POST /v3/buyerservice.asmx HTTP/1.1
Host: api.tradera.com
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Header>
    <AuthenticationHeader xmlns="http://api.tradera.com">
      <AppId>int</AppId>
      <AppKey>string</AppKey>
    </AuthenticationHeader>
    <AuthorizationHeader xmlns="http://api.tradera.com">
      <UserId>int</UserId>
      <Token>string</Token>
    </AuthorizationHeader>
    <ConfigurationHeader xmlns="http://api.tradera.com">
      <Sandbox>int</Sandbox>
      <MaxResultAge>int</MaxResultAge>
    </ConfigurationHeader>
  </soap12:Header>
  <soap12:Body>
    <Bid xmlns="http://api.tradera.com">
      <itemId>int</itemId>
      <bidAmount>int</bidAmount>
    </Bid>
  </soap12:Body>
</soap12:Envelope>
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <BidResponse xmlns="http://api.tradera.com">
      <BidResult>
        <Status>LeadingBidder or HigherBidderExists or NotAllowed or BelowMinimum or Ended or UnexpectedError or NotStarted or RegionNotAccepted or OwnItem or ItemNotFound or NumberOfBidsLimitReached or BelowReservePrice or BidNotAvailableOnItem or ChangedMaxBid</Status>
        <LeadingBidder>
          <Id>int</Id>
          <Alias>string</Alias>
          <TotalRating>int</TotalRating>
        </LeadingBidder>
        <LeadingBid>int</LeadingBid>
        <NextBid>int</NextBid>
      </BidResult>
    </BidResponse>
  </soap12:Body>
</soap12:Envelope>

HTTP GET

The following is a sample HTTP GET request and response. The placeholders shown need to be replaced with actual values.

GET /v3/buyerservice.asmx/Bid?itemId=string&bidAmount=string HTTP/1.1
Host: api.tradera.com
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<BidResult xmlns="http://api.tradera.com">
  <Status>LeadingBidder or HigherBidderExists or NotAllowed or BelowMinimum or Ended or UnexpectedError or NotStarted or RegionNotAccepted or OwnItem or ItemNotFound or NumberOfBidsLimitReached or BelowReservePrice or BidNotAvailableOnItem or ChangedMaxBid</Status>
  <LeadingBidder>
    <Id>int</Id>
    <Alias>string</Alias>
    <TotalRating>int</TotalRating>
  </LeadingBidder>
  <LeadingBid>int</LeadingBid>
  <NextBid>int</NextBid>
</BidResult>

HTTP POST

The following is a sample HTTP POST request and response. The placeholders shown need to be replaced with actual values.

POST /v3/buyerservice.asmx/Bid HTTP/1.1
Host: api.tradera.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length

itemId=string&bidAmount=string
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<BidResult xmlns="http://api.tradera.com">
  <Status>LeadingBidder or HigherBidderExists or NotAllowed or BelowMinimum or Ended or UnexpectedError or NotStarted or RegionNotAccepted or OwnItem or ItemNotFound or NumberOfBidsLimitReached or BelowReservePrice or BidNotAvailableOnItem or ChangedMaxBid</Status>
  <LeadingBidder>
    <Id>int</Id>
    <Alias>string</Alias>
    <TotalRating>int</TotalRating>
  </LeadingBidder>
  <LeadingBid>int</LeadingBid>
  <NextBid>int</NextBid>
</BidResult>

XHTML CSS