REST-API

Programmatischer Zugriff auf Sendungen und Rechnungen — API-Schlüssel unter /api-keys.


Zielgruppe	Entwickler
Voraussetzung	Enterprise-Plan, API-Schlüssel
Dokumentation Schlüssel	API-Schlüssel

Authentifizierung

Alle Anfragen erfordern einen API-Schlüssel:

Authorization: Bearer sk_live_abc123...

Der Schlüssel ist an Ihr Unternehmen gebunden — Sie sehen nur eigene Daten.

Sendungen (Spedition / API)

GET    /api/v1/shipments          — Sendungen auflisten
GET    /api/v1/shipments/:id      — Einzelne Sendung
POST   /api/v1/shipments          — Neue Sendung
PATCH  /api/v1/shipments/:id      — Sendung aktualisieren

Query-Parameter für Listen: Pagination und Filter je nach Implementation im Backend.

Rechnungen

GET    /api/v1/invoices           — Rechnungen auflisten

Webhooks (Zahlungen)

Externe Webhooks für Zahlungsanbieter (Server-zu-Server):

Endpoint	Zweck
`/api/webhooks/stripe`	Stripe-Events (Abo, Rechnungen)
`/api/webhooks/klarna`	Klarna-Bestellstatus

Diese URLs tragen Sie in den jeweiligen Provider-Dashboards ein — nicht mit API-Schlüssel, sondern mit Signatur/Secret des Providers.

Rate Limits

Plan	Limit
Starter	100 Anfragen / Minute
Professional	500 Anfragen / Minute
Enterprise	Nach Vereinbarung

Fehlerformat

{
  "error": "NOT_FOUND",
  "message": "Ressource nicht gefunden",
  "statusCode": 404
}

Lieferdienst-Integration

Für Bestellungen, Produkte und Kunden im Lieferdienst nutzen Sie derzeit primär:

CSV-Export unter /export
Geplante API-Erweiterungen — bei Bedarf [email protected]