Ugradite isporuku u vaš proizvod
REST API za dobijanje cene, kreiranje i praćenje isporuka istog dana – sa potpisanim webhook-ovima, idempotentnim zahtevima, simulatorom test režima i prijemom narudžbina na strani prevoznika.
Cena → kreiranje → praćenje
Izračunajte cenu rute, kreirajte isporuku po ponuđenoj ceni i pratite kurira uz procenjeno vreme dolaska i poziciju uživo.
Potpisani webhook-ovi
HMAC-potpisani događaji za svaku promenu statusa, sa ponovnim pokušajima, DLQ i replay funkcijom. Verifikujte sa tajnim ključem krajnje tačke.
Test režim
mm_test_ ključevi pokreću simulator Robocourier-a kroz celokupan životni ciklus – integrirajte kompletno pre nego što pređete na produkciju.
Prijem flote
Ključevi flote guraju narudžbine iz sistema vaših klijenata direktno u vašu dispečersku tablu.
Autentifikacija
Autentifikujte se sa API ključem ograničenim na organizaciju u x-api-key zaglavlju. Produkcijski ključevi (mm_live_) kreiraju prave narudžbine; test ključevi (mm_test_) kreiraju simulirane isporuke koje nikada ne šalju kurira. Izdajte i opozvavajte ključeve iz vaše Maxmove kontrolne table, ograničene tačno na resurse koji su vam potrebni.
Brzi početak
Pronađite tip vozila, izračunajte cenu rute, pa kreirajte isporuku sa istom rutom, kontaktom za preuzimanje i isporuku i Idempotency-Key-em. Proveravajte praćenje dok isporuka ne stigne. Zamenite ključ i ID ponude svojim vrednostima.
# 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 tačke
| POST | /v1/quotes | Procenite rutu (važi 5 minuta) |
| POST | /v1/deliveries | Kreirajte isporuku za rutu, opciono po ponuđenoj ceni |
| GET | /v1/deliveries/{id}/tracking | Praćenje uživo: ETA, pozicija kurira, polilinija |
| POST | /v1/deliveries/{id}/cancel | Otkažite pre nego što kurir preuzme |
| GET | /v1/deliveries/{id}/proof-of-delivery | Potvrda o isporuci (potpisi, fotografije) |
| POST | /v1/webhooks | Registrujte webhook krajnju tačku |
| POST | /v1/fleet/orders | Gurnite narudžbinu u vašu dispečersku tablu flote |