Authentication

Learn how to authenticate with Topsort APIs using a bearer token

Topsort’s APIs are authenticated via bearer tokens. Requests must include an authorization header containing an API key. If this header is missing or invalid, the HTTP response code will be 401 Unauthorized.

POST /v2/auctions HTTP/2
Host: app.topsort.com
...
Authorization: Bearer <YOUR-API-KEY>
...

Obtaining an API Key

By this point we will have provided you with credentials for our Auction manager. Visit the Auction Manager: API Integration page to generate your API keys.

1. Access API Integration

   Access the Topsort API Integration page by clicking on Settings, and then selecting API Integration.

   
2. Generate API Key

   Generate an API key by pressing the Generate API key button.

   Note that there are two different types of keys: Marketplace API keys and Advanced API keys.

   In order to access the /auctions and /events endpoints, you must create a Marketplace API key. For all other APIs, you need an Advanced API key.

   
3. Copy Key

   Click on the Copy key button to the right of the newly generated token to copy it to your clipboard.

   
4. Use API Key

   Use the API Key on your servers.

Keep api keys secret, this is not a public key. Do not share it with your frontend or clients. API keys are scoped per marketplace. If you have multiple marketplaces, then you will require multiple API keys.