Routes API

Phase 2

Diese Dokumentation ist eine Vorschau. Die API befindet sich derzeit in der Entwicklung.

Endpunkte

Routen auflisten

GET /v1/routes

Abfrageparameter:

Parameter	Typ	Beschreibung
date	string	Nach Routendatum filtern
status	string	not_started, in_progress, completed
driver_id	string	Nach zugewiesenem Fahrer filtern
page	integer	Seitennummer

Route abrufen

GET /v1/routes/{route_id}

Route erstellen

POST /v1/routes

Anfrage-Body:

{
  "date": "2026-03-14",
  "driver_id": "d-001",
  "vehicle_id": "v-003",
  "order_ids": ["se-12345", "se-12346", "se-12347"],
  "optimize": true
}

Wenn optimize: true gesetzt ist, werden die Stopps für die kürzeste Fahrstrecke neu geordnet.

Route aktualisieren

PATCH /v1/routes/{route_id}

Stopps hinzufügen oder entfernen, Fahrer neu zuweisen oder Stopps neu ordnen.

Route löschen

DELETE /v1/routes/{route_id}

Hebt die Zuweisung aller Bestellungen von der Route auf. Bestellungen kehren in den nicht zugewiesenen Pool zurück.

Routenobjekt

{
  "id": "r-001",
  "date": "2026-03-14",
  "status": "in_progress",
  "driver": {
    "id": "d-001",
    "name": "John Driver"
  },
  "vehicle": {
    "id": "v-003",
    "name": "Van #3"
  },
  "stops": [
    {
      "order_id": "se-12345",
      "sequence": 1,
      "status": "delivered",
      "address": "123 Main St",
      "eta": "2026-03-14T10:30:00Z"
    }
  ],
  "estimated_distance_km": 24.5,
  "estimated_duration_min": 85
}