Maxmove logotipas
PrisijungtiPardavimai

Integruokite pristatymą į savo produktą

REST API kainai nustatyti, tos pačios dienos pristatymams kurti ir stebėti – su pasirašytais žiniatinklių kabliukais, idempotentiškais užklausomis, tikrinimo režimo simuliatoriumi ir vežėjo automobilių parko užsakymų priėmimu.

Skaityti dokumentacijąAPI dokumentacijaGauti API raktus

Kaina → kūrimas → stebėjimas

Apskaičiuokite maršruto kainą, sukurkite pristatymą pasiūlyta kaina ir sekite kurjerį su numatomu atvykimo laiku ir gyva buvimo vieta.

Pasirašyti žiniatinklių kabliukai

HMAC pasirašyti įvykiai kiekvienam statuso pakeitimui, su pakartojimais, DLQ ir atkūrimu. Patikrinkite su savo galinio taško slaptažodžiu.

Tikrinimo režimas

mm_test_ raktai paleidžia Robocourier simuliatorių per visą gyvavimo ciklą – integruokite nuo galo iki galo prieš pradėdami realų veikimą.

Automobilių parko priėmimas

Automobilių parko raktai perduoda užsakymus iš jūsų klientų sistemų tiesiai į jūsų siuntų paskirstymo lentą.

Autentifikavimas

Autentifikuokitės su organizacijai priskirtu API raktu x-api-key antraštėje. Tiesioginiai raktai (mm_live_) sukuria tikrus užsakymus; tikrinimo raktai (mm_test_) sukuria modeliuotus pristatymus, kurie niekada nesiunčia kurjerio. Išduokite ir atšaukite raktus iš savo Maxmove valdymo skydelio, apribotus tiksliai toms resursams, kurių jums reikia.

Greitas pradžios vadovas

Raskite transporto priemonės tipą, gaukite maršruto kainos pasiūlymą, tada sukurkite pristatymą su tuo pačiu maršrutu, paėmimo ir pristatymo vietų kontaktu bei Idempotency-Key. Tikrinkite sekimą, kol siunta pasieks paskirtį. Raktą ir pasiūlymo ID pakeiskite savo duomenimis.

# 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"

Galutiniai taškai

POST/v1/quotesĮkainoti maršrutą (galioja 5 minutes)
POST/v1/deliveriesSukurti maršruto pristatymą, pasirinktinai pasiūlyta kaina
GET/v1/deliveries/{id}/trackingTiesioginis stebėjimas: ETA, kurjerio pozicija, maršruto linija
POST/v1/deliveries/{id}/cancelAtšaukti prieš kurjeriui paėmus
GET/v1/deliveries/{id}/proof-of-deliveryPristatymo patvirtinimas (parašai, nuotraukos)
POST/v1/webhooksRegistruoti žiniatinklių kabliuko galutinį tašką
POST/v1/fleet/ordersPerduoti užsakymą į jūsų automobilių parko siuntų paskirstymo lentą
Atidaryti visą interaktyvią dokumentaciją Atsisiųsti OpenAPI specifikaciją