Wofür Zugriffstokens da sind
Ein Zugriffstoken (auch API-Schlüssel genannt) erlaubt deiner eigenen Software, einem Entwickler oder einem Drittanbieter-Tool, über die Storeep-API Daten aus deinem Shop zu lesen. Jedes Token hat eigene Berechtigungen, einen eigenen Datenzeitraum und ein eigenes Ablaufdatum, sodass du jedem Tool genau das gibst, was es braucht, und es jederzeit entfernen kannst, ohne dein Passwort zu teilen.
Öffne Einstellungen > Zugriffstoken. Der Button Dokumentation anzeigen öffnet die API-Referenz mit den Endpunkten, der Art, wie das Token gesendet wird, und den Anfragelimits. Teile diese Seite mit deinem Entwickler.
Möchtest du stattdessen einen KI-Assistenten wie Claude oder ChatGPT verbinden? Dafür werden keine Zugriffstokens verwendet. Siehe Einen KI-Assistenten verbinden.
Ein Token erstellen
Klicke auf Neuen Token erstellen, fülle das Formular aus und klicke auf Erstellen.
- Token-Name: eine Bezeichnung, an der du es in deiner Liste erkennst, zum Beispiel "Buchhaltungs-Sync". Nur du siehst sie.
- Berechtigungen: Hake mindestens eine an:
- Produkte lesen: Produktlisten, Details, Varianten und Lagerbestand.
- Bestellungen lesen: Bestellverlauf, Details, Status und Bestellpositionen.
- Webhooks lesen: Webhook-Konfigurationen und Zustellprotokolle ansehen.
- Webhooks verwalten: Webhook-Abonnements über die API erstellen, aktualisieren und löschen.
- Datenzugriff: wie weit zurück das Token lesen kann.
- Letzte 24 Stunden: nur Daten, die in den letzten 24 Stunden erstellt wurden. Die sicherste Option, gut für Live-Synchronisierungen.
- Startdatum festlegen: nur Daten, die ab einem Datum erstellt wurden, das du unter Startdatum des Datenzugriffs wählst.
- Gesamter Zeitraum: alle deine Daten, ohne Datumsgrenze.
- Ablauf: Läuft nie ab, oder Ablaufdatum festlegen, um ein Datum bis zu einem Jahr im Voraus zu wählen. Nach diesem Datum funktioniert das Token von selbst nicht mehr.
Kopiere dein Token jetzt
Nachdem du auf Erstellen geklickt hast, zeigt das Fenster Ihr Zugriffstoken mit einem Kopier-Button. Dieses Token wird nur einmal angezeigt. Kopiere es und bewahre es sicher auf, zum Beispiel in einem Passwort-Manager. Storeep kann es nicht noch einmal anzeigen. Wenn du es verlierst, lösche das Token und erstelle ein neues.
Behandle es wie ein Passwort. Füge es nie in Website-Code, öffentliche Repositories, Screenshots oder Chatnachrichten ein.
Die Token-Liste
- Vorname, mit dem Erstellungsdatum.
- Berechtigungen: zum Beispiel Produkte lesen oder Bestellungen lesen.
- Datenzugriff: Letzte 24 Stunden, Alle Daten oder Von einem Datum.
- Ablauf: ein Datum oder Nie.
- Zuletzt verwendet: wann ein Tool das Token zuletzt verwendet hat, oder Nie.
Es gibt eine Höchstzahl an Tokens pro Shop. Wenn du sie erreichst, verschwindet der Button Neuen Token erstellen, bis du eines löschst.
Ein Token bearbeiten
Klicke auf ein Token, um Name, Berechtigungen, Datenzugriff oder Ablauf zu ändern. Der Token-Wert bleibt gleich, sodass das Tool, das ihn nutzt, mit den neuen Regeln weiterarbeitet.
Ein Token löschen
Markiere ein oder mehrere Tokens und wähle Token löschen, oder nutze den Papierkorb-Button in einer Zeile. Das Token funktioniert sofort nicht mehr, und jedes Tool, das es nutzt, bekommt einen Fehler.
Tipps
- Gib jedem Tool ein eigenes Token, damit du eines entfernen kannst, ohne die anderen zu stören.
- Wähle den kleinsten Datenzeitraum, der funktioniert.
- Setze ein Ablaufdatum für Freelancer und einmalige Aufträge.
- Ein Token, das lange Nie bei Zuletzt verwendet zeigt, wird wahrscheinlich nicht gebraucht. Lösche es.
- Damit Storeep Bestellereignisse an deinen Server sendet, statt dass dein Server nachfragt, nutze Webhooks.