AuctionGetBidderURL

A service that returns the URL to an auction for one or all bidders.


WEBSERVICE  : http://webservices.vortexauction.com/functions.cfc?wsdl
METHOD      : AuctionGetBidderURL
ARGUMENT    : AUCTIONEER_ID       [Numeric] Required | Your auctioneer ID
              ACCESS_KEY          [String]  Required | Your web service access key
              AUCTION_ID          [Numeric] Optional | The ID of the target auction
              EXTERNAL_AUCTION_ID [String]  Optional | The external ID of the target auction
              BIDDER_ID           [Numeric] Optional | The ID of the bidder to register
              EXTERNAL_BIDDER_ID  [String]  Optional | The external ID of the bidder to register
              PADDLE_NUMBER       [String]  Required | The paddle number identifying the bidder in the specified auction
             

NOTE        : 1. You must specify an AUCTION_ID or EXTERNAL_AUCTION_ID, if both, then only AUCTION_ID will be used.
              2. You can specify a BIDDER_ID, EXTERNAL_BIDDER_ID or PADDLE_NUMBER, when present, BIDDER_ID will be used, followed by EXTERNAL_BIDDER_ID.
              3. If no bidder is specified or the bidder cannot be found, a generic auction url will be returned.


RETURNS     : AuctionGetBidderURLResponse
ON FAILURE  : <?xml version="1.0" encoding="utf-8"?>
              <AuctionGetBidderURLResponse>
                  <Error>
                      <Code>[Error code]</Code>
                      <Message>[Error message]</Message>
                  </Error>
              </AuctionGetBidderURLResponse>
ON SUCCESS  : <?xml version="1.0" encoding="utf-8"?>
              <AuctionGetBidderURLResponse>
                  <URL>[Auction URL]</URL>
              </AuctionGetBidderURLResponse>

ERROR CODES : 00 = An unexpected error occured.
              01 = Missing or invalid arguments.
              02 = Invalid auctioneer ID and/or access key.
              03 = Could not find specified auction.

EXAMPLES    :
              COLDFUSION :
              <cfinvoke webservice="http://webservices.vortexauction.com/functions.cfc?wsdl" method="AuctionGetBidderURL" returnvariable="result">
                  <cfinvokeargument name="Auctioneer_ID" value="0" />
                  <cfinvokeargument name="Access_Key" value="..." />
                  <cfinvokeargument name="Auction_ID" value="0" />
                  <cfinvokeargument name="External_Auction_ID" value="..." />
                  <cfinvokeargument name="Bidder_ID" value="0" />
                  <cfinvokeargument name="External_Bidder_ID" value="..." />
                  <cfinvokeargument name="Paddle_Number" value="..." />
              </cfinvoke>
              <cfdump var=#result# />
              
              PHP :
              class AuctionGetBidderURL {
                  function AuctionGetBidderURL($Auctioneer_ID, $Access_Key, $Auction_ID, $External_Auction_ID, $Bidder_ID, $External_Bidder_ID, $Paddle_Number)
                  {
                      $this->Auctioneer_ID = $Auctioneer_ID;
                      $this->Access_Key = $Access_Key;
                      $this->Auction_ID = $Auction_ID;
                      $this->External_Auction_ID = $External_Auction_ID;
                      $this->Bidder_ID = $Bidder_ID;
                      $this->External_Bidder_ID = $External_Bidder_ID;
                      $this->Paddle_Number = $Paddle_Number;
                  }
              }
              $soapClient = new SoapClient("http://webservices.vortexauction.com/functions.cfc?wsdl");
              $params = new AuctionGetBidderURL(0, "...", 0, "...", 0, "...", "...");
              $result = $soapClient->AuctionGetBidderURL($params);
              var_dump($result);