Ugradite dostavu u svoj proizvod
REST API za izradu ponuda, stvaranje i praćenje dostava istog dana – s potpisanim webhookovima, idempotentnim zahtjevima, simulatorom testnog načina i preuzimanjem narudžbi na strani voznog parka.
Ponuda → stvaranje → praćenje
Izračunajte cijenu rute, izradite dostavu po ponuđenoj cijeni i pratite kurira uz procijenjeno vrijeme dolaska i položaj uživo.
Potpisani webhookovi
HMAC-potpisani eventi za svaku promjenu statusa, s ponovnim pokušajima, DLQ-om i ponovnim pokretanjem. Provjerite s tajnim ključem krajnje točke.
Testni način
mm_test_ ključevi pokreću Robocourier simulator kroz cijeli životni ciklus – integrirajte od početka do kraja prije pokretanja.
Preuzimanje voznog parka
Ključevi voznog parka šalju narudžbe iz sustava vaših kupaca izravno na vašu otpremnu ploču.
Autentifikacija
Autentificirajte se s API ključem ograničenim na organizaciju u x-api-key zaglavlju. Produkcijski ključevi (mm_live_) stvaraju stvarne narudžbe; testni ključevi (mm_test_) stvaraju simulirane dostave koje nikada ne šalju kurira. Izdajte i opozovite ključeve iz svoje Maxmove nadzorne ploče, ograničene točno na resurse koji su vam potrebni.
Brzi početak
Otkrijte vrstu vozila, izračunajte cijenu rute, zatim izradite 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 vlastitima.
# 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"Krajnje točke
| POST | /v1/quotes | Ponuda za rutu (vrijedi 5 minuta) |
| POST | /v1/deliveries | Izradite dostavu za rutu, po želji po ponuđenoj cijeni |
| GET | /v1/deliveries/{id}/tracking | Praćenje uživo: ETA, pozicija kurira, polilinija |
| 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 | Registrirajte webhook krajnju točku |
| POST | /v1/fleet/orders | Pošaljite narudžbu na otpremnu ploču svog voznog parka |