> ## Documentation Index
> Fetch the complete documentation index at: https://docs.topsort.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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`.

```sh theme={null}
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](https://app.topsort.com/new/en-US/marketplace/account-settings/api-integration) para gerar suas API keys.

<Steps>
  <Step title="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**.

    <img src="https://mintcdn.com/topsort/1RZV69Uhic79Ylqv/en/api-reference/api-integration.webp?fit=max&auto=format&n=1RZV69Uhic79Ylqv&q=85&s=e19797f616a2e18801a0642eb7f4c5b3" alt="Screenshot" width="446" height="583" data-path="en/api-reference/api-integration.webp" />
  </Step>

  <Step title="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.

    <img src="https://mintcdn.com/topsort/1RZV69Uhic79Ylqv/en/api-reference/generate-api-key.webp?fit=max&auto=format&n=1RZV69Uhic79Ylqv&q=85&s=225f3845362b2e5f8aded8b54ed9f715" alt="Screenshot" width="1594" height="596" data-path="en/api-reference/generate-api-key.webp" />
  </Step>

  <Step title="Copiar Key">
    Clique no botão **Copy key** à direita do token recém-gerado para copiá-lo para sua área de transferência.

    <img src="https://mintcdn.com/topsort/1RZV69Uhic79Ylqv/en/api-reference/copy-key.webp?fit=max&auto=format&n=1RZV69Uhic79Ylqv&q=85&s=4a97869aa674460d3d203c1fa98599c2" alt="Screenshot" width="1594" height="248" data-path="en/api-reference/copy-key.webp" />
  </Step>

  <Step title="Usar a API Key">
    Use a API Key nos seus servidores.
  </Step>
</Steps>

<Warning>
  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.
</Warning>