Zum Hauptinhalt springen
Topsort verwendet zwei Arten von API-Schlüsseln für unterschiedliche Zwecke.

Schnellreferenz

SchlüsseltypWoZweckBenutzer
Marketplace API KeyAdmin-EinstellungenAlle Marketplace-OperationenBackend-Server
Advanced API KeyAnbieter-DashboardKampagnen eines einzelnen AnbietersAnbieter-Tools

Welchen Schlüssel Benötige Ich?

EndpointSchlüsseltyp
POST /v2/auctionsMarketplace
POST /v2/eventsMarketplace
POST /v2/productsMarketplace
GET /public/v1/reporting-service/*Marketplace
POST /public/v1/campaign-service/*Beide (auf Anbieter beschränkt bei Advanced-Schlüssel)
GET /public/v1/billing-service/*Marketplace

Häufige Fehler

401 Unauthorized

{
  "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

{
  "error": "Forbidden",
  "message": "Insufficient permissions"
}
Ursachen:
  • Verwendung eines Advanced-Schlüssels für einen Endpoint, der einen Marketplace-Schlüssel erfordert
  • Advanced-Schlüssel versucht, auf Daten eines anderen Anbieters zuzugreifen
Lösung: Verwenden Sie den Marketplace API-Schlüssel für anbieterübergreifende Operationen

Wie Erhalte Ich Meine Schlüssel

Marketplace API Key

1

Auf Topsort Admin Zugreifen

Melden Sie sich bei Ihrem Topsort Admin-Dashboard an
2

Zu API-Einstellungen Navigieren

Gehen Sie zu EinstellungenAPI-Integration
3

API-Schlüssel Erstellen

Klicken Sie auf “API-Schlüssel generieren” und wählen Sie “Marketplace API key”
4

Kopieren und Speichern

Kopieren Sie den Schlüssel sofort und speichern Sie ihn sicher (er wird nur einmal angezeigt)

Advanced API Key

1

Auf Anbieter-Dashboard Zugreifen

Melden Sie sich bei Ihrem Topsort Admin-Dashboard an
2

Zu API-Einstellungen Navigieren

Gehen Sie zu EinstellungenAPI-Zugriff
3

Schlüssel Generieren

Klicken Sie auf “Schlüssel generieren”, um Ihren Advanced API-Schlüssel zu erstellen
4

Kopieren und Speichern

Kopieren Sie den Schlüssel und speichern Sie ihn sicher in Ihren Umgebungsvariablen

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

Schlüssel-Berechtigungsumfang

Marketplace API Key

  • Vollzugriff auf alle Marketplace-Operationen
  • Kann Kampagnen für jeden Anbieter erstellen und verwalten
  • Zugriff auf alle Berichtsdaten
  • Erforderlich für Auktions- und Ereignis-Endpoints

Advanced API Key

  • Beschränkt auf Daten eines bestimmten Anbieters
  • Kann nur Kampagnen für den zugehörigen Anbieter verwalten
  • Kann nicht auf Informationen anderer Anbieter zugreifen
  • Ideal für anbieterspezifische Integrationen
Last updated: