Skip to main content
In den API-Einstellungen erstellst du API-Token. Mit einem API-Token können deine eigenen Systeme oder ein Entwickler, der für dich arbeitet, direkt mit Zippendo sprechen: Sendungen erstellen, Bestellungen lesen oder ein Lager- oder Backoffice-System verbinden.

​
Wo du es findest

Öffne das Organisationsmenü unten in der Seitenleiste, klicke auf Verwalten und dann auf den Tab API-Einstellungen. Du siehst deine Token und eine Schaltfläche API-Token hinzufügen. Jeder Tarif enthält API-Token: Free bis zu 2, Standard 5, Growth 10, Pro und Enterprise unbegrenzt.

​
Einen API-Token erstellen

1

Das Fenster öffnen

Klicke auf API-Token hinzufügen (oder auf Ersten Token erstellen, wenn die Liste leer ist).
2

Den Token benennen

Gib einen Token-Name * ein, zum Beispiel „WMS-Integration“ oder „Backoffice“, damit du ihn später wiedererkennst. Du kannst auch Läuft ab in (Tagen) festlegen (bis zu 365) und, wenn deine Organisation Marken hat, Auf Marke beschränken.
3

Die Berechtigungen wählen

Hake die Berechtigungen * an, die der Token braucht, zum Beispiel Sendungen ansehen und Sendungen bearbeiten.
4

Den Token erstellen und kopieren

Klicke auf Token erstellen. Der vollständige Token wird einmal angezeigt, unter API-Token erstellt. Klicke auf Kopieren und bewahre ihn sicher auf: Nach dem Schließen des Fensters kannst du ihn nicht mehr sehen.
Behandle einen API-Token wie ein Passwort. Gib ihn nicht weiter und setze ihn nicht in Code ein, den andere sehen können. Wenn ein Token nach außen gelangt, lösche ihn und erstelle einen neuen.

​
Den Token verwenden

Dein Entwickler sendet den Token im Header Authorization jeder Anfrage: Authorization: Bearer YOUR_TOKEN Die aufzurufende Adresse und jede Anfrage stehen in der API-Referenz. Ein Token erreicht nur die Daten deiner eigenen Organisation.

​
Einen Token auf eine Marke beschränken

Wenn deine Organisation Marken nutzt, kannst du beim Erstellen eines Tokens Auf Marke beschränken festlegen. Jede Anfrage mit diesem Token kann dann nur die Daten dieser Marke lesen und schreiben. Du kannst die Marke später nicht ändern oder entfernen, erstelle also einen neuen Token, wenn du einen anderen brauchst. Ein Token ohne Marke gilt für die ganze Organisation. Ein Entwickler kann eine einzelne Anfrage trotzdem mit dem Header X-Zippendo-Brand auf eine Marke richten und mit dem Header X-Zippendo-Brand-Scope einen Standard für Listenanfragen festlegen (own, shared oder both). Siehe Marken und die API-Referenz.

​
Einen Token löschen

Um einen Token außer Betrieb zu nehmen, zum Beispiel wenn eine Integration eingestellt wird oder der Token offengelegt wurde, klicke in seiner Zeile unter API-Einstellungen auf Löschen. Gib den Namen des Tokens in Großbuchstaben ein und bestätige. Jedes System, das den Token nutzt, funktioniert sofort nicht mehr. Erstelle einen neuen Token, wenn es weiterlaufen soll. Jedes Feld im Detail: API-Token erstellen.