Maxmove für Entwickler
Integriere Lieferung in dein Produkt
Eine REST-API für Angebote, Aufträge und Tracking von Same-Day-Lieferungen — mit signierten Webhooks, idempotenten Requests, Test-Modus-Simulator und Flotten-Auftragsingestion.
Angebot → Auftrag → Tracking
Route kalkulieren, Lieferung aus Angebot oder inline erstellen und den Kurier mit ETA und Live-Position verfolgen.
Signierte Webhooks
HMAC-signierte Events bei jeder Statusänderung, mit Retries, DLQ und Replay. Verifizierung über dein Endpoint-Secret.
Test-Modus
mm_test_-Schlüssel fahren einen Robocourier-Simulator durch den kompletten Lebenszyklus — end-to-end testen, bevor es live geht.
Flotten-Ingestion
Flotten-Schlüssel pushen Aufträge aus den Systemen deiner Kunden direkt in dein Dispatch-Board.
Authentifizierung
Authentifiziere dich mit einem organisationsgebundenen API-Schlüssel im x-api-key-Header. Live-Schlüssel (mm_live_) erstellen echte Aufträge; Test-Schlüssel (mm_test_) erstellen simulierte Lieferungen, die nie einen Kurier disponieren. Schlüssel legst du im Maxmove-Dashboard an und widerrufst sie dort — passend auf genau die Ressourcen zugeschnitten, die du brauchst.
Schnellstart
Fahrzeugtyp ermitteln, Route kalkulieren, Lieferung mit Idempotency-Key erstellen, dann Tracking abfragen. Ersetze Schlüssel und Quote-ID durch deine eigenen.
# 1. Discover vehicle types
curl https://api.maxmove.com/partner/v1/vehicle-types \
-H "x-api-key: $MAXMOVE_KEY"
# 2. Quote a route
curl -X POST https://api.maxmove.com/partner/v1/quotes \
-H "x-api-key: $MAXMOVE_KEY" -H 'content-type: application/json' \
-d '{
"pickup": { "address": "Ehrenstraße 15, Köln", "latitude": 50.9385, "longitude": 6.9469 },
"dropoff": { "address": "Königsallee 27, Düsseldorf", "latitude": 51.2233, "longitude": 6.7768 },
"vehicle_type_id": "courier"
}'
# 3. Create the delivery (retry-safe via Idempotency-Key)
curl -X POST https://api.maxmove.com/partner/v1/deliveries \
-H "x-api-key: $MAXMOVE_KEY" -H 'content-type: application/json' \
-H 'Idempotency-Key: order-4711' \
-d '{ "quote_id": "qt_…", "external_id": "order-4711",
"contact": { "name": "Erika Muster", "phone": "+49 170 0000000" } }'
# 4. Track until delivered
curl https://api.maxmove.com/partner/v1/deliveries/del_…/tracking \
-H "x-api-key: $MAXMOVE_KEY"Endpunkte
| POST | /partner/v1/quotes | Route kalkulieren (5 Minuten gültig) |
| POST | /partner/v1/deliveries | Lieferung aus Angebot oder voller Route erstellen |
| GET | /partner/v1/deliveries/{id}/tracking | Live-Tracking: ETA, Kurier-Position, Polyline |
| POST | /partner/v1/deliveries/{id}/cancel | Abbrechen, bevor der Kurier abholt |
| GET | /partner/v1/deliveries/{id}/proof-of-delivery | Liefernachweis (Unterschriften, Fotos) |
| POST | /partner/v1/webhooks | Webhook-Endpoint registrieren |
| POST | /partner/v1/fleet/orders | Auftrag in dein Flotten-Dispatch-Board pushen |