Лого на Maxmove
ВлезтеПродажби

Вградете доставка в своя продукт

REST API за оферта, създаване и проследяване на доставки в същия ден – с подписани уебхукове, идемпотентни заявки, симулатор за тестов режим и приемане на поръчки от страна на автопарка.

Прочетете документациятаAPI справкаПолучете API ключове

Оферта → създаване → проследяване

Оферирайте цена за маршрут, създайте доставката на оферираната цена и следете куриера с прогнозно време на пристигане и позиция на живо.

Подписани уебхукове

HMAC-подписани събития за всяка промяна в статуса, с повторни опити, DLQ и възпроизвеждане. Потвърдете с вашия endpoint secret.

Тестов режим

mm_test_ ключовете пускат Robocourier симулатор през целия жизнен цикъл – интегрирайте от край до край преди да заработите на живо.

Приемане на поръчки за автопарк

Fleet ключовете изпращат поръчки от системите на вашите клиенти директно в диспечерската ви табла.

Удостоверяване

Удостоверете се с API ключ с обхват на организацията в хедъра x-api-key. Live ключовете (mm_live_) създават истински поръчки; test ключовете (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Проследяване в реално време: очаквано време, позиция на куриера, полилиния
POST/v1/deliveries/{id}/cancelОтменете преди куриерът да вземе пратката
GET/v1/deliveries/{id}/proof-of-deliveryДоказателство за доставка (подписи, снимки)
POST/v1/webhooksРегистрирайте уебхук endpoint
POST/v1/fleet/ordersИзпратете поръчка в диспечерската табла на вашия автопарк
Отворете пълната интерактивна справка Изтеглете OpenAPI спецификация