Autenticação

Aprenda como autenticar com as APIs da Topsort usando um bearer token

As APIs da Topsort são autenticadas por meio de bearer tokens. As solicitações devem incluir um cabeçalho de autorização contendo uma API key. Se este cabeçalho estiver ausente ou for inválido, o código de resposta HTTP será 401 Unauthorized.

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

​

Obter uma API Key

Neste ponto, teremos fornecido credenciais para o nosso Auction manager. Visite a página Auction Manager: API Integration para gerar suas API keys.

1. Acessar a Integração de API

   Acesse a página de integração de API da Topsort clicando em Settings e depois selecionando API Integration.

   
2. Gerar API Key

   Gere uma API key pressionando o botão Generate API key.

   Observe que existem dois tipos diferentes de keys: Marketplace API keys e Advanced API keys.

   Para acessar os endpoints /auctions e /events, você deve criar uma Marketplace API key. Para todas as outras APIs, você precisa de uma Advanced API key.

   
3. Copiar Key

   Clique no botão Copy key à direita do token recém-gerado para copiá-lo para sua área de transferência.

   
4. Usar a API Key

   Use a API Key nos seus servidores.

1. Mantenha as api keys em segredo, isso não é uma chave pública. Não compartilhe com seu frontend ou clientes. 2. As API keys têm escopo por marketplace, se você tiver múltiplos marketplaces precisará de múltiplas API keys.