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

# API-Schlüsseltypen

> Verstehen Sie die zwei Arten von API-Schlüsseln in Topsort und wann Sie welchen für verschiedene Endpoints verwenden.

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 verwendet zwei Arten von API-Schlüsseln für unterschiedliche Zwecke.

## Schnellreferenz

| Schlüsseltyp            | Zweck                                                     |
| ----------------------- | --------------------------------------------------------- |
| **Marketplace API Key** | Auktions- und Ereignis-Endpoints                          |
| **Advanced API Key**    | Katalog-Synchronisierung, Kampagnen, Berichte, Abrechnung |

<Note>
  Die meisten Integrationen benötigen **beide** Schlüsseltypen: einen Advanced-Schlüssel für die Katalog-Synchronisierung, Kampagnen und Berichte sowie einen Marketplace-Schlüssel für Auktionen und Ereignisse.
</Note>

## Welchen Schlüssel Benötige Ich?

| Endpoint                              | Schlüsseltyp |
| ------------------------------------- | ------------ |
| `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     |

## Häufige Fehler

### 401 Unauthorized

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

**Ursachen:**

* API-Schlüssel nicht im `Authorization`-Header enthalten
* Schlüssel ist fehlerhaft oder abgelaufen
* Verwendung eines Advanced-Schlüssels auf einem Marketplace-exklusiven Endpoint

**Lösung:** Überprüfen Sie das Header-Format: `Authorization: Bearer YOUR_API_KEY`

### 403 Forbidden

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

**Ursachen:**

* Verwendung eines Advanced-Schlüssels auf einem Endpoint, der einen Marketplace-Schlüssel erfordert
* Verwendung eines Marketplace-Schlüssels auf einem Endpoint, der einen Advanced-Schlüssel erfordert

**Lösung:** Verwenden Sie den Schlüsseltyp, der zum Endpoint passt — siehe [Welchen Schlüssel Benötige Ich?](#welchen-schlüssel-benötige-ich) oben

## Wie Erhalte Ich Meine Schlüssel

### Marketplace API Key

<Steps>
  <Step title="Auf Topsort Admin Zugreifen">
    Melden Sie sich bei Ihrem Topsort Admin-Dashboard an
  </Step>

  <Step title="Zu API-Einstellungen Navigieren">
    Gehen Sie zu **Einstellungen** → **API-Integration**
  </Step>

  <Step title="API-Schlüssel Erstellen">
    Klicken Sie auf **"API-Schlüssel generieren"** und wählen Sie **"Marketplace API key"**
  </Step>

  <Step title="Kopieren und Speichern">
    Kopieren Sie den Schlüssel sofort und speichern Sie ihn sicher (er wird nur einmal angezeigt)
  </Step>
</Steps>

### Advanced API Key

<Steps>
  <Step title="Auf Topsort Admin Zugreifen">
    Melden Sie sich bei Ihrem Topsort Admin-Dashboard an
  </Step>

  <Step title="Zu API-Einstellungen Navigieren">
    Gehen Sie zu **Einstellungen** → **API-Zugriff**
  </Step>

  <Step title="Schlüssel Generieren">
    Klicken Sie auf **"Schlüssel generieren"**, um Ihren Advanced API-Schlüssel zu erstellen
  </Step>

  <Step title="Kopieren und Speichern">
    Kopieren Sie den Schlüssel und speichern Sie ihn sicher in Ihren Umgebungsvariablen
  </Step>
</Steps>

## Bewährte Sicherheitspraktiken

* **Committen Sie niemals Schlüssel in die Versionskontrolle**
* **Speichern Sie Schlüssel in Umgebungsvariablen**
* **Rotieren Sie Schlüssel regelmäßig**
* **Verwenden Sie verschiedene Schlüssel für verschiedene Umgebungen (dev, staging, produktion)**
* **Beschränken Sie den Schlüsselzugriff nur auf notwendige Teammitglieder**

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