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

​
Schnellreferenz

SchlüsseltypZweck
Marketplace API KeyAuktions- und Ereignis-Endpoints
Advanced API KeyKatalog-Synchronisierung, Kampagnen, Berichte, Abrechnung
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.

​
Welchen Schlüssel Benötige Ich?

EndpointSchlüsseltyp
POST /v2/auctionsMarketplace
POST /v2/eventsMarketplace
/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

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

​
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 Einstellungen → API-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 Topsort Admin Zugreifen

Melden Sie sich bei Ihrem Topsort Admin-Dashboard an
2

Zu API-Einstellungen Navigieren

Gehen Sie zu Einstellungen → API-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