Maxmove logotips
PierakstītiesPārdošana

Iestrādājiet piegādi savā produktā

REST API piedāvājumu iegūšanai, veidošanai un tās pašas dienas piegāžu izsekošanai — ar parakstītiem tīmekļa āķiem, idempotentiem pieprasījumiem, testa režīma simulatoru un pasūtījumu uzņemšanu pārvadātāja pusē.

Lasīt dokumentācijuAPI atsauceIegūt API atslēgas

Piedāvājums → veidošana → izsekošana

Aprēķiniet maršruta cenu, izveidojiet piegādi par aprēķināto cenu un sekojiet kurjeram, redzot ETA un atrašanās vietu reāllaikā.

Parakstīti tīmekļa āķi

HMAC parakstīti notikumi katrai statusa izmaiņai, ar atkārtotiem mēģinājumiem, DLQ un atkārtotu atskaņošanu. Pārbaudiet ar sava galapunkta slepeno atslēgu.

Testa režīms

mm_test_ atslēgas darbina Robokurjera simulatoru caur visu dzīves ciklu — integrējiet no gala līdz galam pirms publicēšanas.

Autoparku uzņemšana

Autoparku atslēgas nosūta pasūtījumus no jūsu klientu sistēmām tieši uz jūsu dispečerpaneli.

Autentifikācija

Autentificējieties ar organizācijas API atslēgu x-api-key galvenē. Dzīvās atslēgas (mm_live_) izveido īstus pasūtījumus; testa atslēgas (mm_test_) izveido simulētas piegādes, kas nekad neizsūta kurjeru. Izdodiet un atsauciet atslēgas no savas Maxmove informācijas paneļa, ierobežojot tās tieši uz vajadzīgajiem resursiem.

Ātrā sākšana

Noskaidrojiet transportlīdzekļa veidu, aprēķiniet maršruta cenu, pēc tam izveidojiet piegādi ar to pašu maršrutu, paņemšanas un nogādāšanas kontaktpersonu un Idempotency-Key. Aptaujājiet izsekošanu, līdz piegāde ir pienākusi. Aizstājiet atslēgu un piedāvājuma ID ar savējiem.

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

Galapunkti

POST/v1/quotesIegūt maršruta piedāvājumu (derīgs 5 minūtes)
POST/v1/deliveriesIzveidot piegādi maršrutam, pēc izvēles par aprēķināto cenu
GET/v1/deliveries/{id}/trackingReāllaika izsekošana: paredzamais ierašanās laiks, kurjera pozīcija, poliline
POST/v1/deliveries/{id}/cancelAtcelt pirms kurjers paņem
GET/v1/deliveries/{id}/proof-of-deliveryPiegādes apliecinājums (paraksti, fotogrāfijas)
POST/v1/webhooksReģistrēt tīmekļa āķa galapunktu
POST/v1/fleet/ordersNosūtīt pasūtījumu uz jūsu autoparku dispečerpaneli
Atvērt pilnu interaktīvo atsauci Lejupielādēt OpenAPI specifikāciju