ادمج التوصيل في منتجك

المصادقة

صادق باستخدام مفتاح API محدد النطاق للمؤسسة في رأس x-api-key. المفاتيح المباشرة (mm_live_) تنشئ طلبات حقيقية؛ مفاتيح الاختبار (mm_test_) تنشئ عمليات تسليم محاكاة لا ترسل أبداً ساعي توصيل. أصدر المفاتيح وألغها من لوحة تحكم Maxmove، محددة النطاق للموارد التي تحتاجها بالضبط.

البداية السريعة

اكتشف نوع المركبة، واحصل على عرض سعر لمسار، ثم أنشئ عملية التسليم بالمسار نفسه مع جهة اتصال للاستلام والتسليم ومفتاح Idempotency-Key. استعلم عن التتبع إلى أن تصل الشحنة. استبدل المفتاح ومعرّف عرض السعر بما يخصك.

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

نقاط النهاية