Spedition Cloud API Q2
Modernes REST-/WebSocket-API für Speditionen: Sendungsmanagement, Tracking, Frachtraten und Lager-Integration — für Cloudora Kunden in Deutschland optimiert.
Technische Highlights
- OAuth2-geschützte Endpunkte mit JWT Access-Tokens
- Webhooks für Event-basiertes Tracking (Zustellung, Scan, Verzögerung)
- Bulk-APIs für Massenerfassung von Lieferungen und Lagerbewegungen
- Kompatibel mit EDI-Konvertern und gängigen TMS/ERP-Schnittstellen
Schematische Darstellung der API-Architektur.
API Endpunkte (Auswahl)
| Endpoint | Methode | Auth | Beschreibung |
|---|---|---|---|
| /api/v2/auth/token | POST | OAuth2 | Token-Ausgabe (Client Credentials / Authorization Code) |
| /api/v2/shipments | GET / POST | Bearer JWT | Sendungsabfragen / Anlage neuer Sendungen (Bulk möglich) |
| /api/v2/shipments/{id}/track | GET | Bearer JWT | Aktueller Status & Tracking-Historie |
| /api/v2/inventory/locations | GET | Bearer JWT | Lagerorte & Bestandsabfrage |
| /api/v2/webhooks | POST | Bearer JWT | Webhook-Registrierung / Bestätigung (HMAC Signatur) |
Alle Endpunkte unterstützen pagination, rate limits und standardisierte Fehlercodes (RFC 7807).
Integrationsleitfaden (Kurz)
Registrieren Sie Ihre Anwendung in der Cloudora Konsole, erhalten Sie Client-ID/Secret, konfigurieren Sie redirect_uris und IP-Whitelist.
Konfigurieren Sie HMAC-Signaturen, prüfen Sie Replay-Tokens, nutzen Sie idempotente Handler für wiederholte Events.
Nutzen Sie standardisierte HTTP-Codes, loggen Sie request/response für Debugging und implementieren Retry mit Backoff bei 5xx.
SDKs & Tools
Offizielle SDKs: Java, Python, Node.js. CLI-Tool zur lokalen Validierung von Webhooks.
Praxisbeispiele & Case Studies
Express-Spedition Berlin
Automatisiertes Buchungs- und Tracking-Interface spart 18% Laderaumkosten.
Stückgut-Spezialist Hamburg
Webhook-gesteuerte Statusmeldungen reduzieren Kundendienstanfragen um 34%.
E-Commerce Fulfillment
Inventory-Sync in Echtzeit ermöglicht 99.7% Verfügbarkeit der Artikel.
Häufige Fragen
OAuth2 mit JWT-Access-Tokens. Empfohlen: Authorization Code Flow für Benutzeranbindung, Client Credentials für Server-zu-Server.
Ja — kompletter Sandbox-Zugang mit Mock-Daten und Webhook-Simulator ist verfügbar nach Registrierung in der Developer-Konsole.
Rate-Limits werden pro ClientID verwaltet; für höhere Durchsätze kontaktieren Sie bitte unseren Support (Vertrag & IP-Whitelist erforderlich).
Release Q2 & Changelog
- v2.4.0: Webhook HMAC-Header erweitert, neue Fehlercodes
- v2.3.1: Performance-Verbesserungen bei Shipments-Bulk
- v2.3.0: Unterstützung für Carrier-Ratenabfragen (rate quotes)