Maxmove Logosu
Oturum açSatış

Ürününüze teslimat entegre edin

Aynı gün teslimatları fiyatlandırmak, oluşturmak ve takip etmek için REST API – imzalı webhook'lar, idempotent istekler, test modu simülatörü ve taşıyıcı tarafında filo sipariş alımı ile.

Dokümanları okuyunAPI referansıAPI anahtarlarını alın

Fiyatlandır → oluştur → takip et

Bir rotanın fiyatını hesaplayın, teslimatı teklif edilen fiyattan oluşturun ve kuryeyi tahmini varış süresi ve canlı konumla takip edin.

İmzalı webhook'lar

Her durum değişikliği için HMAC imzalı olaylar, yeniden denemeler, DLQ ve tekrar oynatma ile. Uç nokta sırrınızla doğrulayın.

Test modu

mm_test_ anahtarları bir Robokurye simülatörünü tam yaşam döngüsü boyunca çalıştırır — canlıya geçmeden önce uçtan uca entegrasyon yapın.

Filo alımı

Filo anahtarları, müşterilerinizin sistemlerinden gelen siparişleri doğrudan sevkiyat panonuza iter.

Kimlik Doğrulama

x-api-key başlığında organizasyon kapsamlı bir API anahtarı ile kimlik doğrulayın. Canlı anahtarlar (mm_live_) gerçek siparişler oluşturur; test anahtarları (mm_test_) asla kurye göndermeyen simüle edilmiş teslimatlar oluşturur. Maxmove kontrol panelinizden, tam olarak ihtiyacınız olan kaynaklara kapsamlı anahtarlar yayınlayın ve iptal edin.

Hızlı Başlangıç

Bir araç tipini keşfedin, bir rota için fiyat teklifi alın, ardından aynı rotayı, alım ve teslim için bir kişiyi ve bir Idempotency-Key'i kullanarak teslimatı oluşturun. Teslimat varana kadar takibi sorgulayın. Anahtarı ve teklif kimliğini kendi değerlerinizle değiştirin.

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

Uç Noktalar

POST/v1/quotesBir rotayı fiyatlandırın (5 dakika geçerli)
POST/v1/deliveriesBir rota için, isteğe bağlı olarak teklif edilen fiyattan teslimat oluşturun
GET/v1/deliveries/{id}/trackingCanlı takip: tahmini varış süresi, kurye konumu, çoklu çizgi
POST/v1/deliveries/{id}/cancelKurye teslim almadan önce iptal edin
GET/v1/deliveries/{id}/proof-of-deliveryTeslimat kanıtı (imzalar, fotoğraflar)
POST/v1/webhooksBir webhook uç noktası kaydedin
POST/v1/fleet/ordersFilo sevkiyat panonuza bir sipariş gönderin
Tam etkileşimli referansı açın OpenAPI özelliğini indirin