Встройте доставку в ваш продукт

Аутентификация

Аутентификация выполняется через 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"

Эндпоинты