Zum Hauptinhalt springen

So verwalten Sie API-Schlüssel

hinweis

Nur der Projektadministrator (der Eigentümer) kann API-Schlüssel sehen und verwalten. Siehe Benutzer.

Wenn Sie eigene Integrationen entwickeln oder externe Werkzeuge mit Ihren StoreLinkr-Daten verbinden möchten, können Sie unsere REST-API nutzen. Dafür müssen Sie ein Paar API-Schlüssel erzeugen.

Neue Schlüssel erzeugen​

  1. Gehen Sie zu Einstellungen > API-Schlüssel.
  2. Klicken Sie auf Neue API-Schlüssel erstellen.
  3. Ein Fenster erscheint mit Ihrem API-Token und Ihrem API-Secret.
warnung

Speichern Sie Ihr Secret! Das API-Secret wird aus Sicherheitsgründen nur einmal angezeigt. Kopieren Sie es sofort und bewahren Sie es an einem sicheren Ort auf (z. B. in einem Passwortmanager).

Die API nutzen​

Die technische Dokumentation unserer öffentlichen API finden Sie unter: https://api.storelinkr.com/api/doc/public_v2

Die API-Schlüssel, die Sie in StoreLinkr verwalten, werden benötigt, um sich bei dieser Dokumentation zu authentifizieren. Sie können Ihr API-Token und Ihr API-Secret direkt im Entwicklerportal verwenden, um Endpunkte zu testen, Datenstrukturen zu erkunden und Ihre eigenen Integrationen zu entwickeln.

Um Ihre Anfragen manuell zu authentifizieren, müssen Sie Ihr Token und Ihr Secret in die Request-Header aufnehmen (X-StoreLinkr-Api-Key und X-StoreLinkr-Api-Secret). Detaillierte Anleitungen und Beispiele finden Sie in unserer Authentifizierungs-Dokumentation.

Schlüssel widerrufen​

Wenn ein API-Schlüssel nicht mehr benötigt wird oder kompromittiert wurde:

  1. Suchen Sie den Schlüssel in der Liste unter Einstellungen > API-Schlüssel.
  2. Klicken Sie auf die Schaltfläche Widerrufen (X).
  3. Bestätigen Sie die Aktion.

Nach dem Widerruf verliert jede Anwendung, die diese Schlüssel verwendet, sofort den Zugriff auf Ihr StoreLinkr-Projekt.

Bewährte Sicherheitspraktiken​

  • Geben Sie Ihr API-Secret niemals weiter, weder in öffentlichen Repositories (wie GitHub) noch an unbefugte Personen.
  • Wechseln Sie Ihre Schlüssel regelmäßig, um ein hohes Sicherheitsniveau zu halten.
  • Widerrufen Sie nicht genutzte Schlüssel, um die Angriffsfläche Ihres Projekts zu verkleinern.