Ugradite dostavu u svoj proizvod
REST API za ponudu, kreiranje i praćenje dostava istog dana – s potpisanim webhookovima, idempotentnim zahtjevima, simulatorom test režima i preuzimanjem narudžbi flote na strani prevoznika.
Ponuda → kreiranje → praćenje
Izračunajte cijenu rute, kreirajte dostavu po ponuđenoj cijeni i pratite kurira uz procijenjeno vrijeme dolaska i poziciju uživo.
Potpisani webhookovi
HMAC-potpisani eventi za svaku promjenu statusa, s ponovnim pokušajima, DLQ i replay. Verificirajte s tajnom vašeg endpointa.
Test režim
mm_test_ ključevi pokreću simulator Robokurira kroz cijeli životni ciklus – integrirajte od početka do kraja prije objave.
Preuzimanje flote
Fleet ključevi guraju narudžbe iz sistema vaših kupaca direktno u vašu dispečing tablu.
Autentifikacija
Autentificirajte se s API ključem vezanim za organizaciju u x-api-key header-u. Live ključevi (mm_live_) kreiraju stvarne narudžbe; test ključevi (mm_test_) kreiraju simulirane dostave koje nikad ne šalju kurira. Izdajte i opozovite ključeve sa svoje Maxmove kontrolne table, s opsegom tačno na resurse koji vam trebaju.
Brzi početak
Pronađite tip vozila, izradite ponudu za rutu, a zatim kreirajte dostavu s istom rutom, kontaktom za preuzimanje i isporuku te ključem Idempotency-Key. Provjeravajte praćenje dok dostava ne stigne. Zamijenite ključ i ID ponude vlastitim vrijednostima.
# 1. Discover vehicle types
curl https://api.maxmove.com/v1/vehicle-types \
-H "x-api-key: $MAXMOVE_KEY"
# 2. Quote a route
curl -X POST https://api.maxmove.com/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: the quoted route plus pickup and dropoff contacts.
# quote_id locks the quoted price; Idempotency-Key makes retries safe.
curl -X POST https://api.maxmove.com/v1/deliveries \
-H "x-api-key: $MAXMOVE_KEY" -H 'content-type: application/json' \
-H 'Idempotency-Key: order-4711' \
-d '{
"quote_id": "qt_…",
"pickup": {
"address": "Ehrenstraße 15, Köln", "latitude": 50.9385, "longitude": 6.9469,
"contact": { "name": "Shop Ehrenstraße", "phone": "+49 221 0000000" }
},
"dropoff": {
"address": "Königsallee 27, Düsseldorf", "latitude": 51.2233, "longitude": 6.7768,
"contact": { "name": "Erika Muster", "phone": "+49 170 0000000" },
"instructions": "Ring at reception"
},
"vehicle_type_id": "courier",
"external_id": "order-4711"
}'
# 4. Track until delivered
curl https://api.maxmove.com/v1/deliveries/del_…/tracking \
-H "x-api-key: $MAXMOVE_KEY"Endpointi
| POST | /v1/quotes | Zatražite ponudu za rutu (važeća 5 minuta) |
| POST | /v1/deliveries | Kreirajte dostavu za rutu, po želji po ponuđenoj cijeni |
| GET | /v1/deliveries/{id}/tracking | Praćenje uživo: ETA, pozicija kurira, poligon |
| POST | /v1/deliveries/{id}/cancel | Otkažite prije nego kurir preuzme |
| GET | /v1/deliveries/{id}/proof-of-delivery | Potvrda dostave (potpisi, fotografije) |
| POST | /v1/webhooks | Registrujte webhook endpoint |
| POST | /v1/fleet/orders | Gurnite narudžbu u vašu dispečing tablu flote |