> ## Documentation Index
> Fetch the complete documentation index at: https://www.zippendo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# API-Einstellungen

> Erstelle und lösche die API-Token, mit denen dein Entwickler deine eigenen Systeme mit Zippendo verbindet.

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

<Steps>
  <Step title="Das Fenster öffnen">
    Klicke auf **API-Token hinzufügen** (oder auf **Ersten Token erstellen**, wenn die Liste leer ist).
  </Step>

  <Step title="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**.
  </Step>

  <Step title="Die Berechtigungen wählen">
    Hake die **Berechtigungen \*** an, die der Token braucht, zum Beispiel **Sendungen ansehen** und **Sendungen bearbeiten**.
  </Step>

  <Step title="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.
  </Step>
</Steps>

<Warning>
  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.
</Warning>

## 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](/docs/api-reference/overview). Ein Token erreicht nur die Daten deiner eigenen Organisation.

## Einen Token auf eine Marke beschränken

Wenn deine Organisation [Marken](/docs/de/settings/brands) 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](/docs/de/settings/brands) und die [API-Referenz](/docs/api-reference/overview).

## 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](/docs/de/how-to/create-an-api-token).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.