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

# Types de Clé API

> Comprendre les deux types de clés API dans Topsort et quand utiliser chacune pour différents endpoints.

export const LastUpdated = ({date, lang = "en"}) => {
  const translations = {
    en: "Last updated:",
    es: "Última actualización:",
    pt: "Última atualização:",
    fr: "Dernière mise à jour:",
    de: "Zuletzt aktualisiert:"
  };
  const label = translations[lang] || translations.en;
  return <>
<style>{`
.last-updated-component {
display: inline-flex;
align-items: center;
gap: 8px;
padding: 10px 16px;
border-radius: 8px;
margin-top: 12px;
margin-bottom: 16px;
font-size: 14px;
background-color: rgba(0, 0, 0, 0.05);
border: 1px solid rgba(0, 0, 0, 0.12);
color: rgba(0, 0, 0, 0.75);
line-height: 1;
}

        .last-updated-component svg {
          flex-shrink: 0;
          vertical-align: middle;
        }

        .last-updated-component span {
          display: inline-flex !important;
          align-items: center !important;
          line-height: 1 !important;
        }

        [data-theme="dark"] .last-updated-component {
          background-color: #3a3a3a;
          border: 2px solid #888888;
          color: #ffffff;
        }

        [data-theme="dark"] .last-updated-component svg {
          stroke: #ffffff;
        }
      `}</style>
      <div className="last-updated-component">
        <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round">
          <circle cx="12" cy="12" r="10" />
          <polyline points="12 6 12 12 16 14" />
        </svg>
        <span>
          <strong style={{
    fontWeight: 600
  }}>{label}</strong> 
          <time dateTime={date}>{date}</time>
        </span>
      </div>
    </>;
};

Topsort utilise deux types de clés API pour différents objectifs.

## Référence Rapide

| Type de Clé             | Objectif                                                        |
| ----------------------- | --------------------------------------------------------------- |
| **Marketplace API Key** | Endpoints d'enchère et d'événement                              |
| **Advanced API Key**    | Synchronisation de catalogue, campagnes, reporting, facturation |

<Note>
  La plupart des intégrations nécessitent **les deux** types de clé : une clé Advanced pour la synchronisation de catalogue, les campagnes et le reporting, et une clé Marketplace pour les enchères et les événements.
</Note>

## Quelle Clé Ai-Je Besoin ?

| Endpoint                              | Type de Clé |
| ------------------------------------- | ----------- |
| `POST /v2/auctions`                   | Marketplace |
| `POST /v2/events`                     | Marketplace |
| `/public/v1/catalog-search-service/*` | Advanced    |
| `/public/v1/campaign-service/*`       | Advanced    |
| `/public/v1/reporting-service/*`      | Advanced    |
| `/public/v1/billing-service/*`        | Advanced    |

## Erreurs Courantes

### 401 Unauthorized

```json theme={null}
{
  "error": "Unauthorized",
  "message": "Invalid or missing API key"
}
```

**Causes :**

* Clé API non incluse dans l'en-tête `Authorization`
* La clé est mal formée ou expirée
* Utilisation d'une clé Advanced sur un endpoint exclusif au Marketplace

**Solution :** Vérifiez le format de l'en-tête : `Authorization: Bearer YOUR_API_KEY`

### 403 Forbidden

```json theme={null}
{
  "error": "Forbidden", 
  "message": "Insufficient permissions"
}
```

**Causes :**

* Utilisation d'une clé Advanced sur un endpoint qui nécessite une clé Marketplace
* Utilisation d'une clé Marketplace sur un endpoint qui nécessite une clé Advanced

**Solution :** Utilisez le type de clé qui correspond à l'endpoint — consultez [Quelle Clé Ai-Je Besoin ?](#quelle-clé-ai-je-besoin) ci-dessus

## Comment Obtenir Vos Clés

### Marketplace API Key

<Steps>
  <Step title="Accéder à Topsort Admin">
    Connectez-vous à votre tableau de bord d'administration Topsort
  </Step>

  <Step title="Naviguer vers les Paramètres API">
    Allez dans **Paramètres** → **Intégration API**
  </Step>

  <Step title="Créer une Clé API">
    Cliquez sur **"Générer une clé API"** et sélectionnez **"Marketplace API key"**
  </Step>

  <Step title="Copier et Stocker">
    Copiez immédiatement la clé et stockez-la en toute sécurité (elle n'est affichée qu'une seule fois)
  </Step>
</Steps>

### Advanced API Key

<Steps>
  <Step title="Accéder à Topsort Admin">
    Connectez-vous à votre tableau de bord d'administration Topsort
  </Step>

  <Step title="Naviguer vers les Paramètres API">
    Allez dans **Paramètres** → **Accès API**
  </Step>

  <Step title="Générer une Clé">
    Cliquez sur **"Générer une Clé"** pour créer votre clé Advanced API
  </Step>

  <Step title="Copier et Stocker">
    Copiez la clé et stockez-la en toute sécurité dans vos variables d'environnement
  </Step>
</Steps>

## Meilleures Pratiques de Sécurité

* **Ne jamais valider les clés dans le contrôle de version**
* **Stocker les clés dans des variables d'environnement**
* **Faire pivoter les clés régulièrement**
* **Utiliser différentes clés pour différents environnements (dev, staging, production)**
* **Restreindre l'accès aux clés uniquement aux membres nécessaires de l'équipe**

<LastUpdated date="2026-06-12" />