> ## 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.

# REST-API-Schnellstart

> Erstelle einen API-Token und sende deinen ersten Aufruf an die öffentliche Zippendo-API aus deinem eigenen System.

Die REST-API lässt deine eigenen Systeme direkt mit Zippendo arbeiten. Dein Onlineshop, ERP oder Lagerverwaltungssystem kann so Sendungen erstellen, Bestellungen lesen und Versandetiketten abrufen, ohne dass jemand die App öffnet. Jeder öffentliche Endpunkt ist im Tab API-Referenz aufgeführt, mit einem Playground zum Ausprobieren von Anfragen.

## 1. API-Token erstellen

<Steps>
  <Step title="API-Einstellungen öffnen">
    Öffne in [app.zippendo.com](https://app.zippendo.com) das Organisationsmenü unten in der Seitenleiste, klicke auf **Verwalten** und dann auf **API-Einstellungen**.
  </Step>

  <Step title="Token erstellen">
    Klicke auf **API-Token hinzufügen**, gib ihm einen Namen (zum Beispiel `Production WMS`), hake die nötigen **Berechtigungen** an und klicke auf **Token erstellen**. Kopiere den Token sofort: Er wird nur einmal angezeigt.
  </Step>

  <Step title="Sicher aufbewahren">
    API-Token beginnen mit `zipp_`. Behandle sie wie Passwörter: Speichere sie in Umgebungsvariablen, nie in der Versionsverwaltung.
  </Step>
</Steps>

Unter [API-Einstellungen](/docs/de/settings/api-settings) findest du Berechtigungen, Ablauf, Markenbeschränkung und das Löschen von Token.

## 2. Organisations-ID finden

Jeder Endpunkt erwartet deine Organisations-ID (`orgId`) im Pfad. Frage Zippendo, zu welcher Organisation dein Token gehört:

```bash theme={null}
curl -X POST https://api.zippendo.com/api-tokens/verify \
  -H "Content-Type: application/json" \
  -d '{ "token": "zipp_YOUR_TOKEN" }'
```

Die Antwort enthält `orgId`, außerdem die `scopes` und `expiresAt` des Tokens.

## 3. Erste Anfrage senden

Sende den Token bei jeder Anfrage als Bearer-Zugangsdaten mit:

```bash theme={null}
curl https://api.zippendo.com/orgs/{orgId}/shipments \
  -H "Authorization: Bearer zipp_YOUR_TOKEN" \
  -H "Content-Type: application/json"
```

Ersetze `{orgId}` durch die ID aus Schritt 2. Der Token braucht für diesen Aufruf die Berechtigung `read:shipments`.

<Warning>
  Setze API-Token nie in Code ein, der in einem Browser oder einer mobilen App läuft. Rufe Zippendo von deinem Backend aus auf.
</Warning>

<Tip>
  Lieber einen typisierten Client? Kostenlose **[SDKs](/docs/de/sdks/overview)** für TypeScript, Python, PHP, Go und Ruby decken jeden Endpunkt ab, sodass du das rohe HTTP überspringen kannst.
</Tip>

Jeder Tarif hat ein Anfragebudget pro Minute. Siehe [Ratenlimits](/docs/api-reference/rate-limits).

## 4. Endpunkte erkunden

Die öffentliche API deckt Folgendes ab:

| Bereich | Typische Nutzung |
| - | - |
| Sendungen | Sendungen erstellen, versenden, aufteilen und verfolgen; Versandetiketten und Dokumente abrufen |
| Bestellungen | Bestellungen erstellen und die Bestellungen lesen, die deine Verkaufskanäle importiert haben |
| Verkaufskanäle | [Eigene Kanäle](/docs/de/order-channels/custom-channels) für deinen eigenen Onlineshop oder dein ERP verwalten |
| Versanddienstleister | Versanddienstleister verbinden, ihre Versandprodukte auflisten und Paketshops suchen |
| Versandpreis | Preise aus deinen Versandregeln für einen Warenkorb im Checkout |
| Versandregeln | Versandregeln lesen und verwalten |
| Webhooks | Benachrichtigt werden, wenn sich Sendungen, Bestellungen und Sendungsverfolgung ändern |
| Adressen | Absender-, Abhol- und Retourenadressen verwalten |

Öffne die [API-Referenz](/docs/api-reference/overview), um Pfade und Anfragekörper zu durchsuchen und Anfragen im Playground auszuprobieren.

## Nächste Schritte

<CardGroup cols={2}>
  <Card title="Webhooks-Schnellstart" icon="webhook" href="/docs/de/quickstarts/webhooks">
    Ereignisse an deinen Server senden, wenn sich Daten ändern.
  </Card>

  <Card title="Versandpreise" icon="calculator" href="/docs/de/quickstarts/shipping-quotes">
    Versandpreise für einen Warenkorb im Checkout anzeigen.
  </Card>

  <Card title="MCP-Server" icon="bot" href="/docs/de/mcp/overview">
    Claude, Cursor oder ChatGPT in Zippendo für dich arbeiten lassen.
  </Card>

  <Card title="Eigene Kanäle" icon="plug" href="/docs/de/order-channels/custom-channels">
    Bestellungen aus deinem eigenen Onlineshop oder ERP an Zippendo senden.
  </Card>
</CardGroup>


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