Maxmove'i logo
Logi sisseMüük

Ehita tarnimine oma tootesse sisse

REST API, mis võimaldab koostada hinnapakkumisi, luua ja jälgida samal päeval tarneid – allkirjastatud webhookide, idempotentsete päringute, testkeskkonna simulaatori ja vedajapoolse autopargi tellimuste vastuvõtmisega.

Loe dokumentatsiooniAPI-dokumentatsioonHangi API-võtmed

Hind → loo → jälgi

Arvuta marsruudi hind, loo kohaletoimetamine pakutud hinnaga ja jälgi kulleri saabumisaega (ETA) ning reaalajas asukohta.

Allkirjastatud webhookid

HMAC-allkirjastatud sündmused iga staatusemuutuse jaoks, koos korduskatsete, DLQ ja taasesitamisega. Kontrolli oma lõpp-punkti saladustega.

Testirežiim

mm_test_ võtmed käivitavad Robocourier-simulaatori läbi kogu elutsükli – integreeri täielikult enne käivitamist.

Autopargi vastuvõtt

Autopargi võtmed suunavad tellimused sinu klientide süsteemidest otse su dispetšeripaneelile.

Autentimine

Autendi organisatsiooni-põhise API-võtmega x-api-key päises. Reaalajas võtmed (mm_live_) loovad päris tellimused; testvõtmed (mm_test_) loovad simuleeritud tarneid, mis kunagi kullerit ei saada. Väljasta ja tühista võtmed oma Maxmove juhtpaneelilt, täpselt nende ressursside ulatuses, mida vajad.

Kiirstart

Leia sõidukitüüp, küsi marsruudile hinnapakkumine ning loo seejärel kohaletoimetamine sama marsruudi, peale- ja mahalaadimise kontakti ning Idempotency-Key'ga. Pärime jälgimisandmeid, kuni kohaletoimetamine on kohal. Asenda võti ja pakkumise ID oma andmetega.

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

Lõpp-punktid

POST/v1/quotesKoosta marsruudile hind (kehtib 5 minutit)
POST/v1/deliveriesLoo marsruudile kohaletoimetamine, soovi korral pakutud hinnaga
GET/v1/deliveries/{id}/trackingReaalajas jälgimine: ETA, kulleri asukoht, polüjoon
POST/v1/deliveries/{id}/cancelTühista enne, kui kuller kauba peale võtab
GET/v1/deliveries/{id}/proof-of-deliveryTarnimistõend (allkirjad, fotod)
POST/v1/webhooksRegistreeri webhooki lõpp-punkt
POST/v1/fleet/ordersSuuna tellimus oma autopargi dispetšeripaneelile
Ava täielik interaktiivne dokumentatsioon Laadi alla OpenAPI-spetsifikatsioon