> ## 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-Key-Verwaltung

> Programmatischer Zugriff zur Verwaltung von Kampagnen und Analysen über Retail-Media- Netzwerke

> [!NOTE]
>
> API-Keys ermöglichen sicheren, programmatischen Zugriff auf Toppies einheitliche Retail-Media-Plattform. Ob Sie Kampagnenmanagement automatisieren, benutzerdefinierte Dashboards erstellen oder Toppie-Daten in bestehende Workflows integrieren – API-Keys bilden die Grundlage für die Skalierung von Retail-Media-Operationen über die Benutzeroberfläche hinaus.

Toppie API-Keys bieten sichere, tokenbasierte Authentifizierung für programmatischen Zugriff auf alle Toppie-Endpunkte. Dies ermöglicht Automatisierung des Kampagnenmanagements, Datenintegration und benutzerdefinierte Reporting-Workflows.

## Wichtige Vorteile

> [card] Kampagnenoperationen automatisieren
>
> Erstellen Sie Workflows, die Kampagnen über mehrere Händler hinweg ohne manuelle Eingriffe erstellen, verwalten und optimieren

> [card] Benutzerdefinierte Integrationen
>
> Verbinden Sie Toppie-Daten mit BI-Tools, Reporting-Dashboards oder internen Systemen für einheitliche Retail-Media-Analysen

> [card] Sichere Zugriffskontrolle
>
> Rollenbasierte Berechtigungen stellen sicher, dass Teammitglieder nur auf die Daten und Funktionen zugreifen, die sie benötigen

## Erstellen von API-Keys

**1. Auf Einstellungen zugreifen**

Navigieren Sie zu **Einstellungen** in der Navigation Ihres Toppie-Dashboards

**2. API-Integration auswählen**

Wählen Sie **API-Integration** aus dem linken Navigationsmenü

**3. Neuen Key erstellen**

Klicken Sie auf die Schaltfläche **"+ Neuer API-Key"**, um einen neuen Key zu generieren

**4. Sofort speichern**

> [!WARNING]
>
> Kopieren und speichern Sie Ihren API-Key sofort – er wird aus Sicherheitsgründen nur einmal angezeigt

**5. Sichere Speicherung**

Speichern Sie Ihren API-Key an einem sicheren Ort wie einem Passwort-Manager oder einem Secret-Management-System

![Toppie API-Integrationsschnittstelle mit Schaltfläche für neuen API-Key](https://mintcdn.com/topsort/uSrfRB5jaD2RxnFe/images/knowledge-base/creating-toppie-api-keys.webp?fit=max\&auto=format\&n=uSrfRB5jaD2RxnFe\&q=85\&s=7096cf2ddd962b839c008ff32ce7fa07)

## Verwendung von API-Keys

Fügen Sie Ihren API-Key in Request-Headern zur Authentifizierung bei Aufrufen der Toppie-API ein.

### Authentifizierungs-Header

```bash theme={null}
curl -X GET https://api.topsort.com/toppie/v1/campaigns \
  -H "Authorization: Bearer YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json"
```

### Verfügbare API-Endpunkte

Zugriff auf vollständige Funktionalität über die Toppie-API:

* **Produktkatalog-Verwaltung** - Kataloge hochladen, aktualisieren und verwalten
* **Kampagnen-Lebenszyklus-Operationen** - Kampagnen erstellen, bearbeiten und überwachen
* **Erweiterte Analysen und Reporting** - Zugriff auf detaillierte Leistungsdaten
* **Budget- und Gebotsverwaltung** - Programmatische Budgetzuweisung und Optimierung

## API-Dokumentation

Die vollständige API-Referenzdokumentation finden Sie in der [Toppie API-Referenz](https://docs.topsort.com/de/api-reference/toppie-api/%5Bbeta%5D-get-toppie-campaigns).

Die Dokumentation umfasst:

* Endpunkt-Spezifikationen und Parameter
* Anfrage-/Antwort-Beispiele
* Fehlerbehandlungsrichtlinien
* Rate-Limit-Informationen
* SDK-Beispiele in mehreren Sprachen

## Best Practices für Sicherheit

> [!WARNING]
>
> **Sicherheitsrichtlinien**
>
> * Teilen Sie API-Keys niemals in Code-Repositories oder öffentlichen Kanälen
> * Rotieren Sie Keys regelmäßig für erhöhte Sicherheit
> * Verwenden Sie Umgebungsvariablen oder sichere Tresore zur Speicherung von Keys
> * Überwachen Sie API-Nutzung auf ungewöhnliche Aktivitäten
> * Implementieren Sie geeignete Zugriffskontrollen in Ihren Anwendungen

### Key-Verwaltung

* **Regenerierung** - Rotieren Sie API-Keys regelmäßig oder wenn Teammitglieder ausscheiden
* **Überwachung** - Verfolgen Sie API-Nutzungsmuster und richten Sie Warnungen für ungewöhnliche Aktivitäten ein
* **Zugriffskontrolle** - Beschränken Sie API-Key-Zugriff nur auf notwendige Teammitglieder
* **Backup-Speicherung** - Speichern Sie Keys an mehreren sicheren Orten mit geeigneten Zugriffskontrollen

## Häufige Anwendungsfälle

### Kampagnenautomatisierung

Automatisieren Sie Kampagnenerstellung, Budgetanpassungen und Leistungsoptimierung basierend auf vordefinierten Regeln und Auslösern.

### Reporting-Integration

Holen Sie Toppie-Leistungsdaten in bestehende Business-Intelligence-Tools oder benutzerdefinierte Dashboards für einheitliches Reporting.

### Inventarverwaltung

Synchronisieren Sie Produktkataloge automatisch und pflegen Sie aktualisiertes Inventar über alle Retail-Partner hinweg.

### Budgetoptimierung

Implementieren Sie benutzerdefinierte Budgetzuweisungsalgorithmen basierend auf Leistungsmetriken und Geschäftszielen.

***

Für Hilfe bei API-Integration oder zur Diskussion fortgeschrittener Anwendungsfälle für programmatisches Kampagnenmanagement wenden Sie sich an Ihren Toppie Account Manager.

***

**Zuletzt aktualisiert:** 
<time dateTime="2025-11-18">2025-11-18</time>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.