Logo Maxmove
Autentificați-văVânzări

Integrează livrarea în produsul tău

Un API REST pentru a calcula, crea și urmări livrări în aceeași zi – cu webhook-uri semnate, cereri idempotente, un simulator pentru modul de testare și ingestie de comenzi pentru flotă din partea furnizorului.

Citiți documentațiaReferință APIObține chei API

Calculează → creează → urmărește

Calculați prețul unui traseu, creați livrarea la prețul ofertat și urmăriți curierul cu ETA și poziție live.

Webhook-uri semnate

Evenimente semnate HMAC pentru fiecare schimbare de stare, cu reîncercări, DLQ și redare. Verifică cu secretul tău de endpoint.

Mod de testare

Cheile mm_test_ rulează un simulator Robocourier prin întregul ciclu de viață – integrează end-to-end înainte de a trece la producție.

Ingestie pentru flotă

Cheile pentru flotă trimit comenzile din sistemele clienților tăi direct în tabloul tău de dispecerat.

Autentificare

Autentifică-te cu o cheie API la nivel de organizație în headerul x-api-key. Cheile live (mm_live_) creează comenzi reale; cheile de test (mm_test_) creează livrări simulate care nu trimit niciodată un curier. Emite și revocă chei din tabloul de bord Maxmove, cu acces limitat exact la resursele de care ai nevoie.

Începere rapidă

Descoperiți un tip de vehicul, cereți o ofertă pentru un traseu, apoi creați livrarea cu același traseu, o persoană de contact pentru ridicare și predare și un Idempotency-Key. Interogați periodic urmărirea până când livrarea ajunge. Înlocuiți cheia și id-ul ofertei cu ale dvs.

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

Endpoint-uri

POST/v1/quotesCalculează un traseu (valabil 5 minute)
POST/v1/deliveriesCreați o livrare pentru un traseu, opțional la un preț ofertat
GET/v1/deliveries/{id}/trackingUrmărire live: ETA, poziția curierului, polilinie
POST/v1/deliveries/{id}/cancelAnulează înainte ca curierul să ridice
GET/v1/deliveries/{id}/proof-of-deliveryConfirmare de livrare (semnături, fotografii)
POST/v1/webhooksÎnregistrează un endpoint webhook
POST/v1/fleet/ordersTrimite o comandă în tabloul de dispecerat al flotei tale
Deschide referința interactivă completă Descarcă specificația OpenAPI