RouteMateRouteMate
API dla deweloperów

Buduj z RouteMate

Połącz swoją platformę przez nasze REST API. Importuj przystanki ze sklepu, uruchamiaj optymalizację trasy i śledź dostawy programowo.

API RouteMate
POST /v1/integration-import

Żądanie

{
  "external_job_id": "BATCH-001",
  "title": "Morning Deliveries",
  "driver_email": "driver@example.com",
  "stops": [
    {
      "external_stop_id": "STOP-1",
      "address": "1 George St, Brisbane QLD 4000",
      "label": "Customer A",
      "parcel_count": 2
    }
  ]
}

Odpowiedź

{
  "job_id": "e7ad097b-...",
  "optimization": {
    "total_distance_km": 12.4,
    "total_duration_minutes": 25
  },
  "stops": [ /* optimized order */ ],
  "warnings": [...]
}

Pobierz dane dostępu

Wygeneruj client ID i secret w ustawieniach panelu RouteMate.

Pobierz token

Wymień dane na bearer token ważny przez godzinę.

Wywołaj API

Dołącz token w nagłówku Authorization do importu i zapytań o status.

Uwierzytelnianie

Przepływ client credentials

API RouteMate korzysta z przepływu OAuth2 client credentials. Wymień client ID i secret na krótkotrwały bearer token, a następnie dołączaj go w nagłówku Authorization.

01

Pobierz dane dostępu

Wygeneruj client ID i secret w ustawieniach panelu RouteMate.

02

Pobierz token

Wymień dane na bearer token ważny przez godzinę.

03

Wywołaj API

Dołącz token w nagłówku Authorization do importu i zapytań o status.

API

Główne endpointy API

Te endpointy obejmują najczęstsze zadania integracyjne w procesie dostaw.

POST/v1/integration-token

Pobierz access token

Wymień client credentials na tymczasowy token dostępu ważny przez godzinę.

Żądanie

{
  "client_id": "rm_ci_your_client_id",
  "client_secret": "rm_cs_your_client_secret"
}

Odpowiedź

{
  "access_token": "rm_at_e5988dd1b91a...",
  "token_type": "Bearer",
  "expires_in": 3600
}
POST/v1/integration-import

Importuj zlecenie i zoptymalizuj trasę

Wyślij zlecenie z przystankami, zgeokoduj adresy, zoptymalizuj kolejność i przypisz zadanie kierowcy.

Żądanie

{
  "external_job_id": "BATCH-001",
  "title": "Morning Deliveries",
  "driver_email": "driver@example.com",
  "stops": [
    {
      "external_stop_id": "STOP-1",
      "address": "1 George St, Brisbane QLD 4000",
      "label": "Customer A",
      "parcel_count": 2
    }
  ]
}

Odpowiedź

{
  "job_id": "e7ad097b-...",
  "optimization": {
    "total_distance_km": 12.4,
    "total_duration_minutes": 25
  },
  "stops": [ /* optimized order */ ],
  "warnings": [...]
}
GET/v1/integration-jobs

Sprawdź status zlecenia

W dowolnym momencie zobacz status zlecenia, postęp przystanków i wyniki dostawy.

Żądanie

// GET request

Odpowiedź

{
  "job_id": "e7ad097b-...",
  "status": "assigned",
  "stop_count": 3,
  "status_counts": {
    "pending": 2,
    "completed": 1
  },
  "stops": [...]
}
Przykłady kodu

Zacznij w kilka minut

Skorzystaj z przykładów poniżej, aby się uwierzytelnić, importować zlecenia i sprawdzać status dostaw.

curl
curl -X POST https://api.routemate.app/v1/integration-token \
  -H "Content-Type: application/json" \
  -d '{"client_id":"rm_ci_your_client_id","client_secret":"rm_cs_your_client_secret"}'
node
const tokenRes = await fetch("https://api.routemate.app/v1/integration-token", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    client_id: "rm_ci_your_client_id",
    client_secret: "rm_cs_your_client_secret",
  }),
});
python
import requests

token_res = requests.post(
    "https://api.routemate.app/v1/integration-token",
    json={
        "client_id": "rm_ci_your_client_id",
        "client_secret": "rm_cs_your_client_secret",
    },
)
Dla zespołów SaaS

Gotowe do produkcji od pierwszego dnia

Zaprojektowane pod niezawodne procesy dostaw, ponowienia i dalsze operacje.

Bezpieczne uwierzytelnianie
Krótkotrwałe bearer tokeny i kontrolowana wymiana danych dostępowych.
Szybkie importy
Przesyłaj dostawy ze swojego systemu jednym żądaniem.
Niezawodne ponowienia
Używaj kluczy idempotencji, aby bezpiecznie powtarzać nieudane żądania.
Widoczność statusu
Śledź zlecenia i postęp przystanków programowo.

Potrzebujesz niestandardowej integracji?

Porozmawiaj z nami o workflow partnerów, indywidualnym onboardingu i dostępie do enterprise API.