REST-API-Schnellstart

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

API-Einstellungen öffnen

Öffne in app.zippendo.com das Organisationsmenü unten in der Seitenleiste, klicke auf Verwalten und dann auf API-Einstellungen.

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.

Sicher aufbewahren

API-Token beginnen mit zipp_. Behandle sie wie Passwörter: Speichere sie in Umgebungsvariablen, nie in der Versionsverwaltung.

Unter API-Einstellungen 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:

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:

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.

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

Lieber einen typisierten Client? Kostenlose SDKs für TypeScript, Python, PHP, Go und Ruby decken jeden Endpunkt ab, sodass du das rohe HTTP überspringen kannst.

Jeder Tarif hat ein Anfragebudget pro Minute. Siehe Ratenlimits.

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 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, um Pfade und Anfragekörper zu durchsuchen und Anfragen im Playground auszuprobieren.

Nächste Schritte

Webhooks-Schnellstart

Ereignisse an deinen Server senden, wenn sich Daten ändern.

Versandpreise

Versandpreise für einen Warenkorb im Checkout anzeigen.

MCP-Server

Claude, Cursor oder ChatGPT in Zippendo für dich arbeiten lassen.

Eigene Kanäle

Bestellungen aus deinem eigenen Onlineshop oder ERP an Zippendo senden.

Start

Schnellstart

Versandablauf

Verbindungen

Betrieb

Organisation & Konto

REST-API-Schnellstart

1. API-Token erstellen

2. Organisations-ID finden

3. Erste Anfrage senden

4. Endpunkte erkunden

Nächste Schritte

Webhooks-Schnellstart

Versandpreise

MCP-Server

Eigene Kanäle

​1. API-Token erstellen

​2. Organisations-ID finden

​3. Erste Anfrage senden

​4. Endpunkte erkunden

​Nächste Schritte

Webhooks-Schnellstart

Versandpreise

MCP-Server

Eigene Kanäle

1. API-Token erstellen

2. Organisations-ID finden

3. Erste Anfrage senden

4. Endpunkte erkunden

Nächste Schritte