RouteMateRouteMate
Entwickler-API

Baue mit RouteMate

Verbinde deine Plattform über unsere REST-API. Importiere Stopps aus deinem Shop, starte Routenoptimierung und verfolge Zustellungen programmatisch.

RouteMate-API
POST /v1/integration-import

Anfrage

{
  "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
    }
  ]
}

Antwort

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

Zugangsdaten holen

Erstelle deine Client-ID und dein Secret in den Einstellungen des RouteMate-Dashboards.

Token anfordern

Tausche deine Zugangsdaten gegen ein Bearer-Token mit einer Gültigkeit von einer Stunde.

API aufrufen

Sende das Token im Authorization-Header für Import- und Statusanfragen mit.

Authentifizierung

Client-Credentials-Flow

Die RouteMate-API verwendet OAuth2 mit Client Credentials. Tausche Client-ID und Secret gegen ein kurzlebiges Bearer-Token und sende es anschließend im Authorization-Header.

01

Zugangsdaten holen

Erstelle deine Client-ID und dein Secret in den Einstellungen des RouteMate-Dashboards.

02

Token anfordern

Tausche deine Zugangsdaten gegen ein Bearer-Token mit einer Gültigkeit von einer Stunde.

03

API aufrufen

Sende das Token im Authorization-Header für Import- und Statusanfragen mit.

API

Wichtige API-Endpunkte

Diese Endpunkte decken die häufigsten Integrationsaufgaben in deinem Lieferworkflow ab.

POST/v1/integration-token

Zugriffstoken abrufen

Tausche Client Credentials gegen ein kurzlebiges Zugriffstoken mit 1 Stunde Gültigkeit.

Anfrage

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

Antwort

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

Job importieren und Route optimieren

Importiere einen Job mit Stopps, geokodiere Adressen, optimiere die Route und weise einen Fahrer zu.

Anfrage

{
  "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
    }
  ]
}

Antwort

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

Jobstatus abfragen

Prüfe Job- und Stoppstatus inklusive Lieferfortschritt und Zählwerten.

Anfrage

// GET request

Antwort

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

In wenigen Minuten starten

Nutze die Beispiele unten, um dich zu authentifizieren, Jobs zu importieren und Lieferstatus abzufragen.

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",
    },
)
Für SaaS-Teams gebaut

Von Tag eins an produktionsreif

Entwickelt für verlässliche Lieferworkflows, Wiederholungen und nachgelagerte Prozesse.

Sichere Authentifizierung
Kurzlebige Bearer-Tokens und kontrollierter Austausch von Zugangsdaten.
Schnelle Importe
Übertrage Lieferungen aus deinem System in einer einzigen Anfrage.
Zuverlässige Wiederholungen
Verwende Idempotenz-Schlüssel, um fehlgeschlagene Requests sicher erneut zu senden.
Status-Transparenz
Verfolge Jobs und Stopfortschritt programmatisch.

Brauchst du eine individuelle Integration?

Sprich mit uns über Partner-Workflows, individuelles Onboarding und Enterprise-API-Zugang.