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

Schnellreferenz

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?

Häufige Fehler

401 Unauthorized

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

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 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 Topsort Admin 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