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

# Authentifizierung

> Erfahren Sie, wie Sie sich mit den Topsort APIs mithilfe eines Bearer Tokens authentifizieren

Die Topsort APIs werden über Bearer Tokens authentifiziert. Anfragen müssen einen Authorization-Header mit einem API-Schlüssel enthalten. Wenn dieser Header fehlt oder ungültig ist, lautet der HTTP-Antwortcode `401 Unauthorized`.

```sh theme={null}
POST /v2/auctions HTTP/2
Host: app.topsort.com
...
Authorization: Bearer <YOUR-API-KEY>
...
```

## Einen API-Schlüssel erhalten

Zu diesem Zeitpunkt haben wir Ihnen Anmeldedaten für unseren Auction Manager bereitgestellt. Besuchen Sie die Seite [Auction Manager: API Integration](https://app.topsort.com/new/en-US/marketplace/account-settings/api-integration), um Ihre API-Schlüssel zu generieren.

<Steps>
  <Step>
    Greifen Sie auf die API-Integrationsseite von Topsort zu, indem Sie auf **Settings** klicken und dann **API Integration** auswählen.

    <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>
    Generieren Sie einen API-Schlüssel, indem Sie auf die Schaltfläche **Generate API key** klicken.

    Beachten Sie, dass es zwei verschiedene Arten von Schlüsseln gibt: Marketplace API Keys und Advanced API Keys.

    Um auf die Endpoints `/auctions` und `/events` zuzugreifen, müssen Sie einen Marketplace API Key erstellen. Für alle anderen APIs benötigen Sie einen 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>
    Klicken Sie auf die Schaltfläche **Copy key** rechts neben dem neu generierten Token, um ihn in Ihre Zwischenablage zu kopieren.

    <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>
    Verwenden Sie den API-Schlüssel auf Ihren Servern.
  </Step>
</Steps>

<Warning>
  1. **Halten Sie API-Schlüssel geheim,** dies ist kein öffentlicher Schlüssel. Teilen Sie ihn nicht mit Ihrem Frontend oder Ihren Clients. 2. API-Schlüssel sind auf Marketplace begrenzt. Wenn Sie mehrere Marketplaces haben, benötigen Sie mehrere API-Schlüssel.
</Warning>