Zum Hauptinhalt springen

​
Einführung

Die Fahrzeuge-API stellt umfassende Endpunkte bereit, um Ihren Fahrzeugbestand über den gesamten Lebenszyklus zu verwalten – von der ersten Anzeige bis zum finalen Verkauf. Dazu gehören Fahrzeugdatenverwaltung, Schadensverfolgung, Inspektionskoordination und Status-Updates.

​
Hauptfunktionen

Bestandsmanagement

Erstellen, aktualisieren, suchen und filtern Sie Ihren Fahrzeugbestand mit erweiterten Suchfunktionen

Schadensverfolgung

Erfassen und verwalten Sie Schadenbewertungen mit detaillierten Berichten und Kostenschätzungen

Inspektionsintegration

Verbinden Sie sich mit KI-gestützten Inspektionsdiensten zur automatisierten Schadenserkennung

Statusablauf

Verfolgen Sie Fahrzeuge durch Status: LOADING, INSPECTED, SOLD mit vollständiger Historie

​
Fahrzeuglebenszyklus

​
API-Endpunkte

​
Fahrzeugverwaltung

EndpunktMethodeBeschreibung
/vehiclesGETAlle Fahrzeuge mit Filtern und Paginierung auflisten
/vehicles/{id}GETFahrzeugdetails per ID abrufen
/vehiclesPOSTNeues Fahrzeug anlegen
/vehicles/{id}PATCHFahrzeuginformationen aktualisieren
/vehicles/{id}DELETEFahrzeug löschen

​
Suche & Filter

EndpunktMethodeBeschreibung
/vehicles/publicGETVeröffentliche öffentliche Fahrzeuge abrufen
/vehicles/status/{status}GETNach Kaufstatus filtern
/vehicles/make/{make}GETNach Marke filtern
/vehicles/location/{location}GETNach Standort filtern
/vehicles/search/{q}GETVolltextsuche über Fahrzeuge

​
Schadensverwaltung

EndpunktMethodeBeschreibung
/vehicles/{id}/completePUTFahrzeugdaten mit Schäden und Analysen vervollständigen
/vehicles/{id}/damagesPOSTSchadenseintrag zum Fahrzeug hinzufügen
/vehicles/{id}/damages/{damageId}DELETESchadenseintrag entfernen
/vehicles/{id}/estimate-damagesPOSTKI-Schadensschätzung auslösen

​
Inspektionsablauf

EndpunktMethodeBeschreibung
/vehicles/phase/preprocess/{id}POSTVorverarbeitungsjob an Fahrzeug hängen
/vehicles/webhooks/ml-resultsPOSTWebhook für ML-Verarbeitungsergebnisse

​
Fahrzeugobjekt-Schema

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "userId": "user_uuid",
  "make": "Honda",
  "model": "Civic",
  "overviewYear": 2021,
  "price": 25000,
  "km": 45000,
  "location": "Casablanca, Morocco",
  "seat": 5,
  "gearBox": "Automatic",
  "fuel": "Gasoline",
  "engineDisplacement": 1800,
  "numberCV": 140,
  "averageConsumption": "6.5L/100km",
  "outside": "Excellent",
  "inside": "Good",
  "ownerNumber": 1,
  "purchaseStatus": "INSPECTED",
  "archive": false,
  "published": true,
  "adNumber": 12345,
  "immatricule": "ABC-1234",
  "overviewImgs": "https://...",
  "postedBy": "Dealer XYZ",
  "functionalities": "GPS, Bluetooth, Cruise Control",
  "feature": "Sunroof, Leather Seats",
  "createdAt": "2024-01-15T10:30:00Z",
  "updatedAt": "2024-01-15T10:30:00Z"
}

​
Abfrageparameter

​
Filteroptionen

Alle Listen-Endpunkte unterstützen folgende Filter:
  • search - Globale Suche über Marke, Modell, Standort
  • make - Nach Fahrzeugmarke filtern
  • model - Nach Fahrzeugmodell filtern
  • minPrice / maxPrice - Preisbereich
  • minYear / maxYear - Baujahresbereich
  • minKm / maxKm - Kilometerbereich
  • fuel - Nach Kraftstoffart filtern
  • gearBox - Nach Getriebetyp filtern
  • location - Nach Standort filtern
  • purchaseStatus - Nach Status filtern (LOADING, INSPECTED, SOLD)
  • published - Nach Veröffentlichungsstatus filtern
  • archive - Nach Archivstatus filtern

​
Paginierung & Sortierung

  • page - Seitennummer (Standard: 1)
  • limit - Einträge pro Seite (Standard: 10, max: 100)
  • sortBy - Sortierfeld (price, overviewYear, km, createdAt)
  • sortOrder - Sortierrichtung (asc, desc)

​
Kaufstatusablauf

​
Status-Übergänge

1

LOADING

Fahrzeug wird dem Bestand hinzugefügt. Bilder und Details werden gesammelt.
2

INSPECTED

Fahrzeug wurde inspiziert. Schadensberichte und Zustandsbewertungen sind abgeschlossen.
3

SOLD

Fahrzeug wurde verkauft. Transaktion abgeschlossen.

​
Schadensobjekt-Schema

{
  "id": "damage_uuid",
  "type": "Dent",
  "severity": "moderate",
  "location": "Front Right Door",
  "description": "Small dent approximately 5cm diameter",
  "estimatedCost": 350,
  "imageUrls": [
    "https://...",
    "https://..."
  ]
}

​
Schweregrade

  • minor - Kosmetischer Schaden, minimale Reparatur nötig
  • moderate - Sichtbarer Schaden, professionelle Reparatur erforderlich
  • severe - Struktureller Schaden, erhebliche Arbeiten erforderlich

​
Ratenlimits

Fahrzeuge-API-Endpunkte folgen den Standard-Ratenlimits:
PlanAnfragen/StundeBurst-Limit
Kostenlos1,00050
Starter10,000200
Professional100,0001,000
EnterpriseUnbegrenztIndividuell

​
Fehlercodes

CodeBeschreibung
VEHICLE_NOT_FOUNDFahrzeug-ID existiert nicht
VEHICLE_ALREADY_SOLDVerkaufte Fahrzeuge können nicht geändert werden
UNAUTHORIZED_VEHICLE_ACCESSBenutzer besitzt dieses Fahrzeug nicht
INVALID_PURCHASE_STATUSUngültiger Statusübergang
DUPLICATE_IMMATRICULEKennzeichen existiert bereits

​
Bewährte Praktiken

Stellen Sie sicher, dass alle Pflichtfelder vorhanden und gültig sind. Nutzen Sie Schema-Validierung, um Fehler zu vermeiden.
Bei Beständen mit 1000+ Fahrzeugen immer Paginierung mit sinnvollen Seitengrößen (10–50) verwenden.
Öffentliche Fahrzeuglisten werden 5 Minuten gecacht. Nutzen Sie dies zur Performance-Optimierung.
Führen Sie Audit-Logs zu Statusänderungen für Compliance und Business Intelligence.

​
Nächste Schritte

Fahrzeuge auflisten

Erfahren Sie, wie Sie Ihren Fahrzeugbestand abrufen und filtern

Fahrzeug erstellen

Fügen Sie neue Fahrzeuge zu Ihrem Bestand hinzu

Schadensverwaltung

Verwalten Sie Schadensberichte und Schätzungen

Suche & Filter

Erweiterte Such- und Filteroptionen