Zum Hauptinhalt springen
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

Kampagnenoperationen automatisieren

Erstellen Sie Workflows, die Kampagnen über mehrere Händler hinweg ohne manuelle Eingriffe erstellen, verwalten und optimieren

Benutzerdefinierte Integrationen

Verbinden Sie Toppie-Daten mit BI-Tools, Reporting-Dashboards oder internen Systemen für einheitliche Retail-Media-Analysen

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

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

Verwendung von API-Keys

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

Authentifizierungs-Header

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. Die Dokumentation umfasst:
  • Endpunkt-Spezifikationen und Parameter
  • Anfrage-/Antwort-Beispiele
  • Fehlerbehandlungsrichtlinien
  • Rate-Limit-Informationen
  • SDK-Beispiele in mehreren Sprachen

Best Practices für Sicherheit

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: