Logo Maxmove
Zaloguj sięSprzedaż

Wbuduj dostawę w swój produkt

REST API do wyceny, tworzenia i śledzenia dostaw tego samego dnia – z podpisanymi webhookami, idempotentycznymi żądaniami, symulatorem trybu testowego i przyjmowaniem zleceń floty po stronie przewoźnika.

Czytaj dokumentacjęDokumentacja APIUzyskaj klucze API

Wycena → tworzenie → śledzenie

Wyceń trasę, utwórz dostawę po wycenionej cenie i śledź kuriera z ETA oraz pozycją na żywo.

Podpisane webhooki

Zdarzenia podpisane HMAC przy każdej zmianie statusu, z ponownymi próbami, DLQ i odtwarzaniem. Weryfikuj za pomocą swojego sekretu punktu końcowego.

Tryb testowy

Klucze mm_test_ uruchamiają symulator Robocourier przez pełny cykl życia – zintegruj end-to-end przed uruchomieniem na żywo.

Przyjmowanie zleceń floty

Klucze floty przekazują zlecenia z systemów Twoich klientów bezpośrednio na Twoją tablicę dyspozytorską.

Uwierzytelnianie

Uwierzytelniaj się za pomocą klucza API w zakresie organizacji w nagłówku x-api-key. Klucze produkcyjne (mm_live_) tworzą prawdziwe zlecenia; klucze testowe (mm_test_) tworzą symulowane dostawy, które nigdy nie wysyłają kuriera. Wystawiaj i cofaj klucze z panelu Maxmove, ograniczone dokładnie do zasobów, których potrzebujesz.

Szybki start

Sprawdź dostępny typ pojazdu, wyceń trasę, a następnie utwórz dostawę z tą samą trasą, kontaktem w miejscu odbioru i dostawy oraz nagłówkiem Idempotency-Key. Odpytuj śledzenie, aż dostawa dotrze na miejsce. Zastąp klucz i identyfikator wyceny własnymi.

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

Punkty końcowe

POST/v1/quotesWycenij trasę (ważne 5 minut)
POST/v1/deliveriesUtwórz dostawę dla trasy, opcjonalnie po wycenionej cenie
GET/v1/deliveries/{id}/trackingŚledzenie na żywo: ETA, pozycja kuriera, polilinia
POST/v1/deliveries/{id}/cancelAnuluj przed odebraniem przez kuriera
GET/v1/deliveries/{id}/proof-of-deliveryPotwierdzenie dostawy (podpisy, zdjęcia)
POST/v1/webhooksZarejestruj punkt końcowy webhooka
POST/v1/fleet/ordersPrzekaż zlecenie na tablicę dyspozytorską Twojej floty
Otwórz pełną interaktywną dokumentację Pobierz specyfikację OpenAPI