Вбудуйте доставку у ваш продукт
REST API для котирування, створення та відстеження доставок у той самий день – з підписаними вебхуками, ідемпотентними запитами, симулятором тестового режиму та прийомом замовлень автопарку з боку перевізника.
Котирування → створення → відстеження
Розрахуйте вартість маршруту, створіть доставку за розрахованою ціною та стежте за кур'єром із розрахунковим часом прибуття й поточним місцезнаходженням.
Підписані вебхуки
Події з HMAC-підписом для кожної зміни статусу, з повторними спробами, DLQ та відтворенням. Перевіряйте з секретом вашої кінцевої точки.
Тестовий режим
Ключі mm_test_ запускають симулятор Robocourier через повний життєвий цикл – інтегруйте від початку до кінця перед виходом у прод.
Прийом замовлень автопарку
Ключі автопарку передають замовлення з систем ваших клієнтів безпосередньо на вашу диспетчерську дошку.
Автентифікація
Автентифікуйтеся за допомогою 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"Кінцеві точки
| POST | /v1/quotes | Котирування маршруту (дійсне 5 хвилин) |
| POST | /v1/deliveries | Створити доставку для маршруту, за потреби за розрахованою ціною |
| GET | /v1/deliveries/{id}/tracking | Відстеження у реальному часі: ETA, позиція кур'єра, ламана |
| POST | /v1/deliveries/{id}/cancel | Скасування до моменту забору кур'єром |
| GET | /v1/deliveries/{id}/proof-of-delivery | Підтвердження доставки (підписи, фотографії) |
| POST | /v1/webhooks | Реєстрація кінцевої точки вебхука |
| POST | /v1/fleet/orders | Передача замовлення на диспетчерську дошку вашого автопарку |