Tradera Developer Program

Push API 

Tradera has a push API that can be used if required. It provides very limited information but can keep you notified of certain events in near realtime (< 30 seconds). It does not replace other API methods since the information sent through the push API is only an item Id or order Id and some timestamp information.

The Tradera push API uses Amazon Web Services Simple Queue Services (AWS SQS) an AWS account is needed for the push API. To enable a user for the SQS we suggest using AWS IAM to create a user and then on the permissions tab attaching the policy AmazonSQSFullAccess. The entry point used is Frankfurt(eu-central-1)

In order to get access to the push API you will first need to create an AWS user (see previous paragraph). To request access contact apiadmin@tradera.com and provide the following information:

  • AWS user account name.
  • AWS user account id.
  • Tradera application id.
  • What your application does and why it needs the push functionality.

API Push sends events from the Tradera system to Amazon SQS. Enabled applications will get access their own queue, to which messages for all authorized members are sent. Authorized members are Tradera users whose accounts have been used to login with the application at TokenLogin. There are two types of messages that can be sent through the queue: OrderCreated and ItemClosed.

OrderCreated

OrderCreated is sent when orders are created. For Auction/AuctionBin/FixedPrice that happens when the buyer confirms the purchase or the auction ends with a winning bid. For ShopItems that happens when the item is payed for.

Example message (JSON):

{"Type":"OrderCreated","OrderId":10187,"SellerMemberId":300124,"CreatedDate":"2015-11-11T14:36:33.9352466Z", "ItemIds": [11111]}

ItemClosed

ItemClosed is sent when an item is closed. That happens in four cases:

  • When Tradera shuts down a listing
  • When the seller shuts down the listing in my tradera
  • When a listing expires without a buyer
  • When a shop item's inventory reaches 0

Example message (JSON):

{"Type":"ItemClosed","ItemId":85592775,"SellerMemberId":300124, "Reason": "ItemClosedByTradera"}

Reason can be one of four values

ItemClosedByTradera
The listing has been shut down by Tradera
ItemClosedBySeller
The listing has been closed by the seller
ItemEndedWithoutBuyer
The item has expired without a buyer
ShopItemQuantityZero
The shop item's inventory has reaced 0

XHTML CSS