API-Quickstart und Authentifizierung

Mit der Maxmove Partner API kalkulieren, erstellen und verfolgen Sie Lieferungen direkt aus Ihrem Shop, ERP, TMS oder Ihrer eigenen Anwendung.

API-Schlüssel anlegen#

API-Schlüssel sind organisationsgebunden und werden im Maxmove-Dashboard unter API-Schlüssel angelegt und widerrufen.

• mm_test_… erstellt ausschließlich simulierte Lieferungen. Es wird kein Kurier disponiert und es entstehen keine Lieferkosten.
• mm_live_… erstellt echte, abrechenbare Lieferungen.
• Senden Sie den Schlüssel im Header x-api-key. Alternativ wird Authorization: Bearer mm_… unterstützt.
• Beschränken Sie jeden Schlüssel auf die benötigten Scopes: quotes:create, deliveries:read, deliveries:write und webhooks:manage.
• Flottenintegrationen verwenden zusätzlich fleet_orders:create und fleet_orders:read für die Auftragsingestion.

Erste Testlieferung#

1. Rufen Sie GET /partner/v1/vehicle-types auf und wählen Sie eine vehicle_type_id.
2. Kalkulieren Sie die Route mit POST /partner/v1/quotes.
3. Erstellen Sie die Lieferung mit POST /partner/v1/deliveries, der zurückgegebenen quote_id und einem eindeutigen Idempotency-Key.
4. Lesen Sie Lieferung und Tracking über GET /partner/v1/deliveries/{id} und GET /partner/v1/deliveries/{id}/tracking.
5. Registrieren Sie für automatische Statusupdates einen Endpoint unter POST /partner/v1/webhooks.

Alle Requests und Responses verwenden snake_case. Zeitstempel werden als RFC-3339 in UTC übertragen, Geldbeträge als Centbetrag plus Währung.

Vor dem Wechsel auf Live#

• Testen Sie Erfolgs-, Storno- und Fehlerpfade mit einem mm_test_…-Schlüssel.
• Prüfen Sie Webhook-Signaturen über dem unveränderten Request-Body.
• Speichern Sie API- und Webhook-Schlüssel ausschließlich in einer sicheren Secret-Verwaltung.
• Wechseln Sie anschließend auf einen mm_live_…-Schlüssel; Endpunkte und Payloads bleiben identisch.

Die vollständige interaktive Referenz finden Sie unter https://api.maxmove.com/partner/v1/docs, die OpenAPI-Spezifikation unter https://api.maxmove.com/partner/v1/openapi.json.