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

# Authentification

> Apprenez comment vous authentifier avec les APIs Topsort en utilisant un bearer token

Les APIs de Topsort sont authentifiées via des bearer tokens. Les requêtes doivent inclure un en-tête d'autorisation contenant une API key. Si cet en-tête est manquant ou invalide, le code de réponse HTTP sera `401 Unauthorized`.

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

## Obtenir une API Key

À ce stade, nous vous aurons fourni des identifiants pour notre Auction manager. Visitez la page [Auction Manager: API Integration](https://app.topsort.com/new/en-US/marketplace/account-settings/api-integration) pour générer vos API keys.

<Steps>
  <Step>
    Accédez à la page d'intégration API de Topsort en cliquant sur **Settings** puis en sélectionnant **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>
    Générez une API key en appuyant sur le bouton **Generate API key**.

    Notez qu'il existe deux types différents de keys : Marketplace API keys et Advanced API keys.

    Pour accéder aux endpoints `/auctions` et `/events`, vous devez créer une Marketplace API key. Pour toutes les autres APIs, vous avez besoin d'une 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>
    Cliquez sur le bouton **Copy key** à droite du token nouvellement généré pour le copier dans votre presse-papiers.

    <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>
    Utilisez l'API Key sur vos serveurs.
  </Step>
</Steps>

<Warning>
  1. **Gardez les api keys secrètes,** ce n'est pas une clé publique. Ne la
     partagez pas avec votre frontend ou vos clients. 2. Les API keys ont une portée par
     marketplace, si vous avez plusieurs marketplaces, vous aurez besoin de plusieurs API keys.
</Warning>